Lens

Segments

Segments are reusable filter sets you can apply to any board tile. Define a segment once, then re-use it across boards without rebuilding the same filters every time.

What a segment is

A segment is a named filter that lives independently of any single tile. Instead of adding the same five filter rules ("country in US", "device is mobile", "channel = organic") to every chart on every board, you define them once as a segment called Mobile Organic US and pick that segment on whatever tiles need it.

Segments are scoped to one base table. The dimensions and metrics available for filtering come from that table's schema. To filter a board that uses a Join or Union table, build the segment against the combined table directly.

Create a segment

Open Lens > Segments from the left sidebar and click Add Segment. Pick the base table the segment will run against. The form populates with that table's dimensions so you can choose which to filter on.

Add filter rules one at a time. Each rule is a dimension, an operator (equals, not equals, contains, starts with, in, greater than, less than, is null), and a value. Multiple rules combine with AND logic, so a row must match every rule to be included.

Give the segment a clear, specific name. "US Organic" beats "Segment 1" when you're picking from a dropdown six months later. Save the segment.

Apply a segment on a board

Open any board that uses the segment's base table. Edit a tile and pick the segment from the Segment dropdown. The tile re-renders with only the matching rows. Save the tile to make the segment selection permanent.

Segments stack with tile-level filters. If a tile has both a segment and a filter, both must match for a row to appear. That makes segments good for the recurring slices and tile filters good for one-off variations.

Tip

Use segments instead of duplicating tiles. One Sessions tile + four segments (Desktop, Mobile, Tablet, All) is cleaner and easier to maintain than four near-identical tiles.

Edit and propagate changes

Editing a segment changes every tile that uses it on the next render. That's the value: tighten a definition once and every board updates. It's also the risk: be deliberate about what counts as Mobile Traffic before twenty boards depend on the answer.

Troubleshooting

Segment doesn't appear in the tile dropdown

The tile is built from a different base table than the segment. Segments only show up for tiles that match. Either pick a tile based on the segment's table, or rebuild the segment against the table the tile uses.

Tile shows zero rows after applying the segment

Filter rules combine with AND, so any rule that doesn't match anything in the table empties the result. Check each rule individually, especially "in" lists, where a typo in one of the values can knock the whole segment out.