# Metrics

**Metrics** are calculations based on data that aim to answer specific business questions.

Customize the columns using the ![](/files/2qSgPtoqlNo1YzsBK7Tw) icon in the header, or use the keyboard shortcut `Cmd/Ctrl+F` to open a search filter.

<figure><img src="/files/0TqcuqZyRgydieLwT2Cm" alt=""><figcaption></figcaption></figure>

To add a new metric, click **+ New Doc -> Metric**.

Name your metric.

You can create an empty metric, or search for a measure field that represents the metric.

<figure><img src="/files/4KizykDFYcse8txE2Ari" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
Note: When you choose a Column/Fields to Represent a Metric, this Column will now display with a 'Metric' label:
{% endhint %}

<figure><img src="/files/SqyPfj0GanGurkESoDE3" alt=""><figcaption></figcaption></figure>

Then click the 'Metric' label to see everywhere this Column represents a Metric:\\

<figure><img src="/files/mq6qxVRyaKx4p4T6vrbj" alt="" width="563"><figcaption></figcaption></figure>

Select Star can automatically detect dimensions that you may want to group or pivot on, but you can remove these if desired or search for others.

<figure><img src="/files/nJvQBaSd6Go5kYs494Mk" alt="" width="375"><figcaption></figcaption></figure>

Save the metric to see new fields where you can provide a **Description**, **Business Questions to Answer**, and **How it's Calculated** as editable fields.

<figure><img src="/files/63Q6wcDV2Tplen0ec2jy" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Type `@` and then a few characters to create a clickable link to a specific data asset within your calculation or description.
{% endhint %}

The **How it's calculated** field is meant to give a high-level overview of the metric to business-oriented stakeholders.

If you have a SQL query which will show a more accurate representation to technical stakeholders, you can add it where you'd modify the [Owners](/data-management/data-ownership.md) by clicking **< > SQL**.

<figure><img src="/files/v8Q3Kz6XvfVDHBg7w48A" alt=""><figcaption></figcaption></figure>

You'll be able to edit or paste in a SQL query.

![](/files/-MiOKtnf2IUD5tUbF1Ep)

Stakeholders can also use the [Discussion](/features/discussion.md) tab to ask questions or make comments about the metric.

The owners will be notified of any comments. By default, both the Business and Technical Owner of a metric are set to the person who created it. [Data Managers and Admins](/user-management/user-roles.md) can change the Owners as needed, and even apply [Tags](/features/tags.md) to metrics by clicking the 🏷 icon next to the title.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.selectstar.com/features/documents/metrics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.