> For the complete documentation index, see [llms.txt](https://helpdesk.smaply.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdesk.smaply.app/metrics/how-to-choose-a-metric-type.md).

# How to choose a metric type

Pick Series, Number, or Comparison so your data lands on the card in the shape that tells your story.

The type you pick decides how a metric's data is shaped and how it renders on a card. You choose it from the **Type** dropdown in the metric builder, after you name the metric and pick a source. For the full build flow, see [How to create and configure a metric](https://helpdesk.smaply.app/metrics/how-to-create-and-configure-a-metric.md).

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-2cbebb35ebed8bab2838be4cb37e77e04c7341b7%2Fmetrics-04-type-picker.png?alt=media" alt="The Type dropdown in the metric builder, open to show three options: Series, Number, and Comparison, each with an icon."><figcaption><p>The Type dropdown in the metric builder</p></figcaption></figure>

There are three types. Match the type to the question your data answers.

#### Series

A sequence of data points, such as monthly signups or responses broken down by category. Pick Series when you have many values to plot and you want to show a trend over time or a breakdown across categories.

Series data renders as a **Bar**, **Horizontal bar**, **Pie**, **Line**, or **Table** chart, chosen in the card options. A line chart suits a trend over time; bars and pie suit category breakdowns; a table suits exact figures.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-6cd4c560b0f826457197a9bf8e4c4ea15de1e5ca%2Fmetrics-mined-series-line-chart.png?alt=media" alt="A metric card rendering Series data as a line chart, showing a monthly trend with a data-point tooltip."><figcaption><p>Series rendered as a line chart</p></figcaption></figure>

#### Number

A single standalone value, such as current CSAT or total revenue. Pick Number when you want to spotlight one headline figure.

A Number renders either as the value on its own, or as a semi-circular gauge that shows the value against an optional target. Use the gauge when the figure is most meaningful relative to a goal.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-7cf158bad203574618097c1451a850e20f7c2e51%2Fmetrics-mined-number-gauge-display.png?alt=media" alt="A metric card showing a single value on a semi-circular gauge, with the value positioned against a target range."><figcaption><p>Number rendered as a gauge against a target</p></figcaption></figure>

#### Comparison

Two values contrasted, such as this quarter against last. Pick Comparison when the story is the change between exactly two figures.

A Comparison renders as a value with a percentage-change line below it, or as two bars side by side. The percentage line shows the direction and size of the change at a glance.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-f4c4bd74f47bec96c23913195a4c094c60b526f7%2Fmetrics-mined-comparison-display.png?alt=media" alt="A metric card showing a single value with a percentage-change line below it, indicating a decrease."><figcaption><p>Comparison rendered with a percentage-change line</p></figcaption></figure>

#### Which type should I use?

|                | **Series**                               | **Number**                          | **Comparison**                                   |
| -------------- | ---------------------------------------- | ----------------------------------- | ------------------------------------------------ |
| **Best for**   | Trends over time or category breakdowns  | One headline figure                 | The change between two values                    |
| **Data shape** | Many data points                         | A single value                      | Exactly two values                               |
| **Renders as** | Bar, horizontal bar, pie, line, or table | A value or a gauge against a target | A value with a percentage change, or paired bars |

The type also sets which render options are available: Series gives you the five chart types, Number gives you the value or gauge, and Comparison gives you the percentage line or paired bars. You can change the render in the card options at any time. Once a type fits, build the metric in [How to create and configure a metric](https://helpdesk.smaply.app/metrics/how-to-create-and-configure-a-metric.md).

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-ba34ff7d418672b12537561174911abf8d1a8025%2Fmetrics-07-card-preview.png?alt=media" alt="A metric card on a journey map rendering Series data as a vertical bar chart titled Website signups."><figcaption><p>A Series metric on a card</p></figcaption></figure>

#### Related topics

<table data-column-title-hidden data-view="cards"><thead><tr><th>Article</th><th>What it covers</th><th data-hidden data-card-target data-type="content-ref">Target</th></tr></thead><tbody><tr><td><strong>How to create and configure a metric</strong></td><td>Build a metric from name to saved card, for any source and type.</td><td><a href="https://helpdesk.smaply.app/metrics/how-to-create-and-configure-a-metric.md">Create and configure a metric</a></td></tr><tr><td><strong>How to use manual metrics with CSV</strong></td><td>Enter Series data by hand, paste from a spreadsheet, or upload a CSV.</td><td><a href="https://helpdesk.smaply.app/metrics/how-to-use-manual-metrics-with-csv.md">Manual metrics with CSV</a></td></tr><tr><td><strong>How to use metric cards</strong></td><td>Display a metric on a journey map and switch its chart type per card.</td><td><a href="https://helpdesk.smaply.app/journey-maps/cards/how-to-use-metric-cards.md">Metric cards</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpdesk.smaply.app/metrics/how-to-choose-a-metric-type.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
