> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mentionlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Filters & Sharing

> Slice your data by date range, tags, AI models and more, then share the exact view

One filter bar sits above every analysis page. Change anything in it and every card on screen
refetches, so the whole page always describes the same slice of data.

## Date range

The **date range picker** lives in the top navigation bar, to the right. Presets: **Today**,
**Last 7 days**, **Last 30 days**, **Last 3 months**, **Last 6 months**, **Last 12 months**,
**This week**, **This month**, **This year**, or pick a custom range on the two-month calendar and
click **Apply**. The picker has its own **Reset**, which hands the date back to its automatic
default.

> [!NOTE]
>
> The default window is anchored on your project's **last execution**, not on today: `to` is the
> date of the most recent run and `from` is three months before it. If a project's schedule has
> been paused for a while, it opens on a window that ends when the data ends.

***

## The filter bar

Left to right, the bar holds four facets, a popover for the rest, the custom-filter button and the
sharing control.

### Primary filters

| Filter | Description |
| - | - |
| **Tags** | Query tags and [tag groups](https://docs.mentionlab.io/guides/queries-and-tags.md#tag-groups). Selecting one reveals an **OR** / **AND** mode toggle (default AND) |
| **AI Models** | Limit results to specific platforms |
| **Countries** | Grouped by continent: Africa, Asia, Europe, North America, Oceania and Latin America |
| **Languages** | Limit results to the language a query was written in |

> [!NOTE]
>
> Continent groups start **collapsed**. Use the chevron to open one, or click the heading to select
> every available country in it at once. Mexico sits under **Latin America**.

### Availability

Every facet is availability-aware. A value with no data under your other active filters is greyed out
and carries the tooltip "No results with the current filters", and a group heading shows how many of
its members are still available. Tick **Hide unavailable** in a dropdown to drop them from the list
entirely; the choice is remembered in your browser.

> [!NOTE]
>
> **Countries** and **Languages** list only the values with data inside the current date window, and
> **AI Models** only the models that actually ran in this project. Two projects will show different
> options.

### The Filters popover

Click **Filters** for the rest. The button carries a badge counting how many secondary filters are
active.

| Filter | Type | Values |
| - | - | - |
| **Response tags** | Multi-select | Tags and their groups, plus an **OR** / **AND** mode toggle (default AND) |
| **Show all entities** | Switch | On = include entities seen in only one answer (off by default) |
| **Entity scope** | Switch | On = "Only show configured owned & competitors" |
| **Group entities** | Three-way | **None** (one row per entity) · **Divisions** · **Groups** |
| **Sources** | Three-way | **All** · **Sources** · **No sources** |
| **Shopping** | Three-way | **All** · **Shopping** · **No shopping** |
| **Ads** | Three-way | **All** · **Ads** · **No ads** |

> [!WARNING]
>
> **Sources**, **Shopping** and **Ads** narrow the population of responses, which changes the
> denominator of every rate on the page. Filtering to **Sources** pins Source rate at 100% by
> definition.

> [!NOTE]
>
> **Show all entities** is off by default, so a brand named in a single answer does not appear in your
> entity tables. Turn it on when you are hunting long-tail competitors.

> [!NOTE]
>
> The **Languages** facet sits in the main bar but counts toward the Filters badge: the badge can
> read 1 while the popover looks untouched.

### Group entities

Three levels, not an on/off switch:

* **None**: one row per entity.
* **Divisions**: one row per division; entities with no division get their own row.
* **Groups**: one row per top-level group, with divisions rolled up.

Changing this level clears any active **View as** pin, because a pinned row is identified by a key
minted at one specific level.

### Custom filters

The **+** button beside **Filters** pins a filter you use constantly onto its own row under the bar.
Pick a **tag group** or a **continent**, and the pinned chip then drives the same Tags or Countries
selection as the main facets.

> [!NOTE]
>
> Custom filters are saved on the project, so every member sees the same pins. Only project
> **managers** can add or remove them.

### Reset

**Reset** appears once any filter is off its default. It clears every filter **except the date
range**, which is deliberately left where you put it.

***

## Sharing a filtered view

Click **Share** at the right end of the bar. It mints a link to the current page carrying the exact
filters and date window, plus the **View as** pin if one is active:

> Anyone with access to this project will land on this page with exactly these filters.

Click **Copy** and send it. There is no other way to hand someone a filtered view. The URL does not
track your filters while you browse.

***

## Filter persistence

Your selection is saved **per project** in your browser:

* Return within **12 hours** and it is reapplied automatically, with a "Filters restored" toast.
* Return later and you're offered it: a toast with an **Apply** button, once per project per
  session. Closing that toast declines the offer and discards the saved selection.
* Switching project loads that project's own saved selection, not the one you were just using.
* Only a date range you picked yourself is saved. An automatic window is not.

A link with filter parameters wins over the saved selection. Those parameters are applied on landing
and then stripped from the address bar.

***

## Combining filters

Filters stack across categories. For example:

1. Set the date range to the last 30 days
2. Filter by the `Pricing` tag
3. Limit to ChatGPT and Claude
4. Set **Sources** to **Sources**

That leaves only cited responses to pricing questions on two platforms.

> [!WARNING]
>
> Stacking filters shrinks the sample fast. A mention rate computed over six responses is not a
> trend. Start broad and narrow down.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.