> ## 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.

# Sandbox

> Compose your own metrics and arrange them on dashboards

The **Sandbox** lets you build your own metrics and show them as charts on dashboards. Open
**Sandbox** in the side menu.

## Dashboards

The name of the open dashboard is the page title. Click it to switch dashboards, to search them, or
to add a **New dashboard**. With two dashboards or more, **Reorder dashboards** sets the list order.

A dashboard belongs to the project. Everyone on the project sees it, with its name and description.
There are no private dashboards. A name holds up to 120 characters, a description up to 2,000.

**Edit dashboard → Dashboard actions** holds **Color palette** (the ten colors the charts use),
**Rename dashboard**, **Duplicate dashboard** and **Delete dashboard**. A delete removes the
dashboard and its charts for everyone. The metrics stay. **Fullscreen** (or the **F** key) shows the
cards alone.

## Edit a dashboard

**Edit dashboard** (or the **E** key) opens the edit bar: **Metrics**, **Widget**, **Dashboard
actions**, **Cancel** and **Save dashboard**. Your changes to the cards and the colors stay in a draft
until you click **Save dashboard**. A rename, a duplicate or a delete saves at once.

* **Widget** adds a **Chart**, a **Section** (a title across the row), a **Text** card or a **Spacer**.
* Drag a card to move it. Drag its edges to resize it.
* Each card has its own buttons to edit it, **Duplicate** it or **Remove** it.

A dashboard holds at most 100 charts. If a colleague saves the dashboard while you edit it, you choose
**Load their version** or **Replace with my version**.

## Charts

A chart shows one or more saved metrics. The chart panel has six steps and a live preview: **Metrics
to show**, **Chart type**, **Breakdown by**, **Sort**, **Widget header** and **Own filters**.

| Chart type | Metrics | Breakdown |
| - | - | - |
| **Number card** | 1 or 2 | None. A second metric shows as the small number beside the first |
| **Line**, **Area**, **Bars over time** | 1 to 5 | **Over time**, and optionally one line, area or bar per value |
| **Stacked over time** | 1 | **Over time** and **Stack by** |
| **Bar** | 1 to 3 | **Compare across** |
| **Stacked bar** | 1 | **Bars** and **Stack by** |
| **Radar** | 1 to 3 | **One axis per** |
| **Scatter** | 2 | **One point per**. The first metric is drawn across, the second up |
| **Pie**, **Donut**, **100% bar** | 1 | **Slices** or **Parts** |
| **Table** | 1 to 5 | Optional **Columns to break down by** |
| **Heatmap** | 1 | **Rows** and **Columns** |

A chart type that cannot draw your metrics is greyed out, with the reason.

* **Breakdown by** offers **Entity**, **Engine**, **Query**, **Tag**, **Country**, **Language**,
  **Source domain**, **Retailer**, **Product**, **Fan-out** and more. **Over time** takes a grain:
  **Day**, **Week** or **Month**. A chart takes at most 3 breakdowns, **Over time** included.
* A chart that draws one line, area or bar per value keeps the 10 highest values.
* A breakdown can keep only some values. It can also let viewers pick the values, or switch the
  breakdown with tabs on the card.
* A **Table** shows 25 rows per page. It can number the rows, or show a metric as the change of the
  metric above it.
* A **Number card** can show one entity's number, as a **Value** or a **Rank** among every entity.

## Metrics

A metric belongs to the project, so every dashboard can draw it. **Metrics** in the edit bar opens the
library, with the tabs **All**, **Custom** and **Built in**. Each row has **Edit metric**,
**Duplicate metric** and **Delete metric**. The charts of a deleted metric say that it was deleted.

> [!WARNING]
>
> A change to a metric changes every chart that uses it, on every dashboard. To keep the old version,
> use **Save as a new metric**.

### Built-in metrics

You cannot change a built-in metric. **Copy a built-in metric** in the chart panel opens the builder
on a copy. Once you save it, the copy is a metric of the project. See the
[Glossary](https://docs.mentionlab.io/guides/metrics-glossary.md) for the definitions.

| Metric | What it measures |
| - | - |
| **Entity visibility rate** | The share of AI answers that mention your entity |
| **Share of voice** | Of every entity appearance in AI answers, the share that is yours |
| **Average position** | How high in the answer your entity usually appears. Lower is better |
| **Sentiment** | How AI answers speak about your entity, from -1 to +1 |
| **Domain citation share** | Of every site cited in AI answers, the share one site holds |
| **Ads rate** | The share of answers that carry any ad |

To chart the ads that answers carry, use the measures **Answers with ads**, **Ad cards** and
**Answers carrying ads**, and the breakdowns **Has ads**, **Ad format** and **Advertiser**.

### Build a metric

**New metric** opens the builder. It has four steps and a live preview.

1. **Inputs**: each input (A, B, C...) counts one measure from **What to count**, for example
   **Answers collected** or **Answers mentioning the entity**. A metric holds up to 8 inputs.
2. **How they combine**: a **Ratio** divides input A (the top) by input B (the bottom).
   **Share of total** divides A by its total across a breakdown, such as **Entity**. The other
   choices are **Just A**, **Index to the leader**, **Change vs previous period** and **Custom formula**.
3. **Format**: **Percent**, **Number** or **Fraction**, with 0 to 4 decimals. Turn on
   **Lower is better** for a metric such as a position.
4. **Name**: unique in the project, up to 120 characters. The description shows in the library.

Each input has its own filters: **Entities**, **Entity groups**, **Engines** and **Tags**. An input
can also **Use data from the period just before the selected dates**.

**Ignore page filters** makes an input count its data even when the filter bar filters on
**Sources** or **Shopping**. Use it on the bottom of a ratio. For example, you divide
**Answers with sources** (A) by **Answers collected** (B), and you set **More → Sources** to
**Sources**. B then counts only answers with sources, and the metric reads 100%. Set
**Ignore page filters: Sources** on B, and B counts all answers again.

## Filters and dates

The filter bar and the date apply to every chart on the dashboard. The entity you analyze in the top
bar applies to the charts whose metrics count it. See [Filters and sharing](https://docs.mentionlab.io/guides/filters-and-comparisons.md).

**Own filters** sets filters for one chart only: **Date range**, **Engines**, **Entities**,
**Entity groups** and **Tags**. Each can be **Same as the dashboard**, **Only these…** or
**All (ignore the dashboard's choice)**. A chart's own date range ends on the project's last run.

The date's comparison (**Previous period**, **Same period last year**) does not apply to the charts.
To show a change, use a **Change vs previous period** metric. What a viewer changes on a card (sort, search, page, tab) resets on reload.

## Who can edit

A **Viewer** sees the dashboards but cannot change them. To create or edit dashboards and metrics,
you need the **Editor**, **Manager** or **Admin** role. See
[Organization and billing](https://docs.mentionlab.io/guides/organization-and-billing.md).


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