> For the complete documentation index, see [llms.txt](https://docs.multitudes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.multitudes.com/configuration-and-setup/customize-targets.md).

# Customize Targets

Set custom performance targets for your metrics.

To give an idea of what “good” looks like, our charts show industry benchmarks. We use these industry benchmarks as the default target to drive insights that we share in the app and via our notifications. To see where the benchmark comes from, look for the green "What good looks like" section of each metric's documentation:

{% hint style="success" %}
**What good looks like**

Look for a box like this one to see what research the industry benchmarks are based on.&#x20;
{% endhint %}

Your team can customize these targets to set your own goals, because teams may have different considerations. As examples, hardware or mobile teams might have a slower `Change Lead Time` due to physical operations or waiting for app approvals, or a team might want to beat the industry benchmarks.&#x20;

{% hint style="warning" %}
Note: When you set a custom target, all the charts and insights for that team / organization will change to reflect the target.
{% endhint %}

## How to customize targets

There are two ways to customize targets:

**(1) Update targets on the Settings page**

**Go to** [**Settings > Targets**](https://app.multitudes.co/team-settings/targets)**,** or click the “Customize targets” button on the top right of the *At a glance* section on the My Insights homepage (see image below).

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FSL5p5BET67ZlZiQfHdoW%2FMy%20Insights_Customize%20Targets.png?alt=media&amp;token=64c27a9c-1e74-40bd-803c-7abbb9c6dc11" alt=""><figcaption></figcaption></figure>

On the Settings page, click on the target you want to update and edit it (see gif below).&#x20;

In the table below:

* Rows represent teams (including a row for the organization as a whole at the top)
* Columns represent the metrics
* Each cell represents a target

For a cell with a given team row and metric column, if the text of the cell is colored:

* **Black**, this means the current target is unchanged from the industry benchmark (the industry benchmark is shown on the first gray row, for reference)
* <mark style="color:$primary;">**Teal**</mark>, this means a custom target has been set

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FmAZkISVmHxBut1HaJNK4%2F642d0711ddda445619d2b35e_Targets-Settings-V2.gif?alt=media&amp;token=fa609d22-570e-46ee-bbae-9242cbaefe86" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Note that this table currently lets you set targets for 5 of our metrics, `Change Lead Time`, `Merge Frequency`, `Change Failure Rate`, `Out-of-Hours Work`, and `PR Participation Gap`. To set targets on other metrics, use the option below.
{% endhint %}

**(2) Update targets from a chart legend**

Wherever you see a chart with a green target zone, you can customize the target by going to the legend and clicking on the small target icon next to the “Target” label. This will show a modal from which you can edit the target. Click “Save Changes” to trigger a chart refresh. See gif below for the full flow.

<figure><img src="https://cdn.prod.website-files.com/610c8a14b4df1ae46b1a13a3/642b2ada9327355c002cb0cd_GIF%20for%20Custom%20Targets.gif" alt=""><figcaption></figcaption></figure>

When you're updating a target from the chart, check what group you're editing it for. The group name is at the top of the modal (highlighted in the image below). To change the group shown, change the "Team" filter at the top of the page. From this modal, we only let you update for one group (either one team or the organization) at a time.

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FxsfZ4dDa0OgcQTwsSF1R%2Fimage.png?alt=media&amp;token=bf8660e0-fac1-4f4a-9c38-6104d8dfee8c" alt=""><figcaption></figcaption></figure>

## How the timescale impacts targets

You can choose to show Multitudes chart with data aggregated daily, weekly, or monthly. If the metric depends on the timescale (e.g., merge frequency, which looks at merged PRs per week, or feedback given, which looks at comments/reviews given per week), then targets scale automatically as you change the timescale:

* If you move from weekly to daily, the target is divided by 7
* If you move from daily to monthly, we scale the target by 365/12 (365 days of the year divided by 12 months in the year).&#x20;

For example, if your merge frequency goal was 5 merged PRs/person/week, then if you change the timescale you would get:

* Daily goal: 5/7 = 0.71 merged PRs/person/day
* Monthly goal: 5/7 \* 365/12 = 21.73 merged PRs/person/month

When you edit targets from the legend, the timescale shows in the same units as your filter at the top of the page. See example below for Merge Frequency at the monthly timescale – the industry benchmark has scaled, and the target is shown based on merged PRs/person/month.&#x20;

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FK74gblWW7zVAOYNCOs4p%2Fimage.png?alt=media&amp;token=a9686b9f-61fb-405a-92ea-5be76ded8d91" alt=""><figcaption></figcaption></figure>
