Skip to main content

Type filters

Filters let you refine which objects within a type you're looking at, based on attribute values. Combining several filters narrows results to precisely what you need.

Example​

A Vehicle type has attributes Brand, Color, and Model Year. With three filters defined — brand is Volvo, color is yellow or black, and model year is 1971–1996 — enabling them independently or together narrows the list:

  • Only Filter 1 → all Volvos
  • Only Filter 2 → all yellow or black cars
  • Filter 1 + Filter 3 → all Volvos from 1971–1996

Enabled filters are combined with a logical AND.

Anatomy of a filter​

  • State — enabled or disabled.
  • Name — the label shown on the filter button.
  • StarQL expression — the StarQL query that determines which objects match.

Creating a filter​

  1. Navigate to the type, and click Filter.
  2. Click Create filter.
  3. Enter your criteria as a StarQL expression, and press Enter to apply it.
  4. To save it, open the context menu → Save as new filter, name it, and save.
🔒 Volvo🔓 Yellow or black+ Filter

Mockup, not a screenshot — confirmed against components/TypeFilter/TypeFilter.tsx and SplitToggleDropdown.tsx. Each saved filter is a pill that toggles on/off; the lock icon shows whether it's Restricted (only its owner can see it) or Open (shared with the workspace). Clicking "Filter" opens a new, unsaved filter row below.

🔒 Volvo🔓 Yellow or black+ Filter
Brand = Volvo AND "Model Year" in (1971, 1996)
Search✓ Save⋮

Mockup, not a screenshot — confirmed against TypeFilterStarQLInput.tsx. Typing a StarQL expression and clicking Search (or pressing Enter) applies it right away; Save (or the ⋮ menu's "Save as new filter") is what persists it as a named, shareable filter.

Save filter

Save filters that you use often for quick access

Volvo 1971-1996
CancelSave

Mockup, not a screenshot — confirmed against TypeFilterModal.tsx.

Sharing filters​

A filter starts Restricted — visible only to its creator. The owner can make it Open, sharing it with everyone in the workspace. Only the owner can edit the query, delete it, or change its sharing state, regardless of whether it's open or restricted.