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

# Metrics

> Learn how to model user interactions using Trophy Metrics. Model any user interaction and power agentic messaging and in-app features with just a few lines of code.

## What are metrics?

Customer engagement starts with how users interact with your product. At Trophy, we use the term **Metrics** to refer to the data objects that model those interactions within your web or mobile app.

Metrics are un-opinionated, meaning they can be used to model absolutely any user interaction you can think of. Examples could include:

* Followers, likes or posts
* Tasks completed
* Miles ran
* Lessons completed
* Words written
* ...

Metrics are the event layer for customer engagement. They power both Trophy's [agentic messaging](https://docs.trophy.so/agentic-messaging/overview.md) and its in-app features. Each user interaction that relates to a metric is stored as an [Event](https://docs.trophy.so/data-sources/events.md).

Events are stored and processed in chronological order. At any particular point in time, the combined state of a user's event history reflects their overall progress on your platform.

## Key attributes

Here we describe the key attributes that allow you to create metrics to best fit your use case.

### Units

You can easily assign units to metrics in the dashboard for either:

* Arbitrary numbers (tasks, posts, messages etc.)
* Currencies (\$, £, €)

## Creating metrics

To create a Metric, head over to the [Metrics](https://app.trophy.so/metrics) page within Trophy and click the **New Metric** button:

<video autoPlay muted loop playsInline src="https://mintcdn.com/trophy/vvlxkggAvglghNGz/assets/features/metrics/create_new_metric.mp4?fit=max&auto=format&n=vvlxkggAvglghNGz&q=85&s=cc3973a9f482a19232065f7648ef62d2" />

**1. Enter a name**

Choose a name for the metric.

**2. Click save**

Save the new metric.

**3. Configure settings**

Configure additional settings like metric units or currency if applicable on the metric configure page.

## Metric analytics

Trophy has a built-in analytics dashboard for each metric you create. It shows you:

* The total value of all tracked events against the metric
* The number of users actively making progress against the metric
* The metric's [Milestone Completion Chart](#achievement-completion-chart)

![](https://mintcdn.com/trophy/rGjOHIeZYrVU9hOo/assets/features/metrics/metric_analytics.png?fit=max\&auto=format\&n=rGjOHIeZYrVU9hOo\&q=85\&s=92edeb77c958a8a77dd11506a9d0be86)

### Milestone completion chart

The milestone completion chart shows the current state of the userbase in terms of the number of users who have completed each milestone that you've configured against this metric.

[Learn more about milestones](https://docs.trophy.so/features/milestones.md).

![](https://mintcdn.com/trophy/rGjOHIeZYrVU9hOo/assets/features/metrics/achievement_completions.png?fit=max\&auto=format\&n=rGjOHIeZYrVU9hOo\&q=85\&s=29113a61395c95f09bb8d6755caff17a)

## Frequently asked questions

> [accordion] How many metrics can I create?
>
> As many as you want!

> [accordion] Can Trophy control my UI when events are tracked?
>
> No, metrics are purely server-side and only support the business logic around milestones, streaks and other workflows like sending messages.
>
> They don't control any in-app UI, but our APIs provide all the data you need to build whatever UI you want.

## Get support

Want to get in touch with the Trophy team? Reach out to us via [email](mailto:support@trophy.so). We're here to help!


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