Conditional Item Visibility
Control which items appear in your widget using creator-configured rules. Visitors never see these rules — they just see the filtered results.
Setting Up Visibility Rules
- Open your widget in the editor
- Go to the Source tab
- Expand the Conditional Item Visibility accordion
- Click Add Rule
Each rule has three parts:
- Column — the data source column to evaluate
- Condition — one of: equals, is not empty, is empty, contains, does not contain
- Value — the value to match against (not required for “is empty” and “is not empty” conditions)
Match Mode
When you have multiple rules, choose how they work together:
- Show items that match Any rule — items appear if they satisfy at least one rule (OR logic)
- Show items that match All rules — items must satisfy every rule to appear (AND logic)
Where It Works
Visibility rules apply everywhere your widget is displayed:
- All layouts (grid, list, table, etc.)
- Published pages
- Embeds
- Script installs
Example Use Cases
- Only show items where Status equals “Published”
- Hide draft items by setting a rule where Status does not contain “Draft”
- Show only items that have images by setting Image is not empty
- Display items from a specific category without exposing the filter to visitors
Visibility Rules vs Filters
Visibility rules and filters serve different purposes:
- Visibility rules are configured by you (the creator) and are invisible to visitors. They control which items are included in the widget at all.
- Filters are visitor-facing controls that let your audience narrow down the visible items themselves.
You can use both together — visibility rules determine the base set of items, and filters let visitors refine within that set.
Visibility rules are evaluated before filters. If a rule hides an item, it won’t appear in filter options either.
Related
- Filters — Let visitors filter data in your widget
- Items & Details — Understand item lists and details pages
- Sorting — Allow visitors to reorder data
Last updated on