Cross filtering
Click a value on one Mosaic tile and filter every other tile by it, with a clear chip, dimmed tiles, and a shareable URL.
Country: India).When to use it — When you spot something interesting on one tile and want every other tile to reflect just that slice.
Where to find it — On any data Mosaic: click a chart point or bar, then choose Filter dashboard by this value from the interaction menu. The active cross-filter shows as a chip in the Filters toolbar.
Who can use it — Tracer, Weaver, and Luminary. Anyone who can open the Mosaic can cross-filter it.
Cross filtering lets you take a value from one tile and use it to constrain the entire dashboard. Instead of editing filters by hand, you click the value you care about and apply it everywhere at once. The clicked tile stays highlighted, the rest dim to show they are now scoped to that value, and a chip in the toolbar tells you exactly what is being filtered.
The interaction is explicit. Clicking a chart value does not filter anything by itself — it opens a small menu where cross-filtering is one of several choices, so you always know what an action will do before it happens.
Overview
When you click a value on a Mosaic tile, Celiq opens an interaction menu anchored at your click position. From that menu you can:
- Filter dashboard by this value (cross-filter every tile)
- Drill into a sub-dimension
- View the underlying rows in Discover
- Explain the value with Orion
Choosing Filter dashboard by this value sets a single structured cross-filter and applies it across the whole Mosaic. The cross-filter is one object with four fields:
{
"tileId": "tile_abc123",
"field": "country",
"value": "India",
"label": "Country: India"
}tileId— the tile you clicked (the source tile)field— the dimension being filtered (the cross-filter is on the dimension, not the metric of the clicked bar)value— the value to filter tolabel— the human-readable text shown on the chip, for exampleCountry: India
When tiles re-run, this cross-filter is carried in each tile's run body as cross_filters, and the backend resolves whether it applies to a given tile. The active cross-filter is also written to the page URL so the filtered view can be shared or reloaded.
When to use it
- You see a spike or outlier on one chart and want every tile to show only that segment.
- You want to compare one slice across many tiles at once (one channel, one country, one product) without editing each chart.
- You want to share a pre-scoped view of a dashboard — the cross-filter travels in the URL, so a colleague opening your link sees the same filtered state.
If instead you want to keep the same chart but break a value down by a different dimension, use Drill down. If you want durable, configured filters that stay on the dashboard, use Filters.
Concepts
| Term | Meaning |
|---|---|
| Cross-filter | A single structured filter { tileId, field, value, label } set by clicking a value and choosing Filter dashboard by this value. |
| Source tile | The tile you clicked to create the cross-filter. It is highlighted, not dimmed. |
| Interaction menu | The popup that opens on click, offering cross-filter, drill, view rows, and explain. Clicking a value never applies a filter on its own. |
cross_filters | The field in each tile's run request that carries the active cross-filter so the backend can apply it per tile. |
| Cross-filter chip | The pill in the Filters toolbar showing the active cross-filter's label, with a Reset button. |
| Reset interactions | The action that clears the cross-filter plus any open drill menu or drill-through, returning the Mosaic to its unfiltered state. |
Getting started
Cross filtering works on data tiles that render an interactive chart (for example bar, line, and similar charts). Presentational tiles such as text, dividers, and media have nothing to click, so they cannot start a cross-filter.
To use cross filtering you only need:
- A Mosaic with at least one data tile.
- A chart whose values you can click (a bar, a point, a segment).
Open the Mosaic you want to explore. No edit mode is required — cross filtering works while you are simply viewing the dashboard.
Step-by-step
Open a Mosaic and find a value
Open the Mosaic and locate the tile and value you want to filter the dashboard by — for example a single bar on a "Revenue by country" chart.
Click the value to open the interaction menu
Click the bar, point, or segment. A small menu opens at your click position, headed by the value you clicked (for example Country: India). Nothing is filtered yet — the click only opens the menu.
Choose Filter dashboard by this value
Select Filter dashboard by this value (labeled cross-filter every tile, marked with the ⌖ icon). Celiq sets the cross-filter and re-runs the tiles.
Read the visual treatment
The tile you clicked stays highlighted with a purple ring; every other tile dims to show it is now scoped to your value. A chip appears in the Filters toolbar reading, for example, ⌖ Country: India.
Share the view (optional)
The active cross-filter is encoded in the page URL as ?crossFilter=. Copy the URL to share the exact filtered state, or reload to restore it.
Reset when done
Click Reset on the cross-filter chip to clear the cross-filter and return the dashboard to its full, undimmed state.
Examples
Suppose you have a Mosaic with three tiles: revenue by country, orders over time, and top products. You notice India is unusually high on the country tile and want every tile to reflect India only.
- Click the India bar on the revenue-by-country tile. The interaction menu opens with the heading
Country: India. - Choose Filter dashboard by this value.
Celiq sets this cross-filter:
{
"tileId": "tile_revenue_by_country",
"field": "country",
"value": "India",
"label": "Country: India"
}When the tiles re-run, each one receives the cross-filter in its run body. The shape carried per tile is:
{
"cross_filters": [
{ "field": "country", "operator": "=", "value": "India" }
]
}The revenue-by-country tile (the source) stays highlighted; orders-over-time and top-products dim and re-run scoped to India. The toolbar shows the chip ⌖ Country: India, and the URL gains a ?crossFilter= parameter holding the base64-encoded cross-filter. Sending that link to a teammate opens the same India-scoped view.
Best practices
- Treat the highlighted tile as your anchor — it is the source of the current cross-filter, so you always know where the filter came from.
- Use the chip label to confirm what is applied before you read the rest of the dashboard. The label always names the dimension and value (for example
Country: India). - Share the URL, not a screenshot, when you want a colleague to land on the same filtered view — the cross-filter is encoded in the link.
- Reach for cross filtering for quick, exploratory slicing. For filters that should persist on the dashboard for everyone, configure proper Filters instead.
Tips
The cross-filter is applied on the dimension, not the metric of the bar you clicked. Clicking the tallest revenue bar for India filters by country = India, not by the revenue number — so the label reads Country: India, not the dollar value.
Common mistakes
Forgetting a cross-filter is active. A dimmed dashboard with a chip in the toolbar means a cross-filter is in effect. If numbers look smaller than expected, check for a
⌖ chip and Reset it.Stacking interactions. Only one cross-filter is active at a time. Choosing a new value replaces the current cross-filter rather than adding to it.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| Clicking a value does nothing | The chart point did not resolve to a dimension field and value (for example a presentational tile, or a point with no identifiable dimension) | Click a data tile with a clear dimension (bar, point, or segment); presentational tiles cannot start a cross-filter. |
| The menu opens but the dashboard is not filtered | You opened the interaction menu but did not choose an action | Select Filter dashboard by this value to apply the cross-filter. |
| Other tiles are dim and numbers look low | A cross-filter is active | Click Reset on the ⌖ chip in the Filters toolbar to clear it. |
| A reopened link is already filtered | The shared URL carried a ?crossFilter= parameter | This is expected — the cross-filter is restored from the URL. Click Reset to clear it. |
| A tile ignores the cross-filter | The cross-filter's field does not apply to that tile | This is expected: the cross-filter is resolved per tile, so tiles that do not contain the field stay unfiltered. |