# Activity Thresholds

Activity thresholds are a way of quickly assessing how reps are working their assigned accounts. Are they doing enough of the right kinds of activities? 

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2FQThk5eUVJ0tvx0xnxHzj%2FScreenshot%202025-08-05%20at%209.05.20%E2%80%AFAM.png?alt=media&#x26;token=33add973-2a40-4163-b70b-f9cd557f45a1" alt=""><figcaption></figcaption></figure>

Watch a short demo here or keep scrolling for setup information and other details.&#x20;

{% embed url="<https://app.storylane.io/share/angjfz1pmgfg>" %}

### Configuring activity thresholds

You need to configure activity thresholds and assign them to a target book for the reporting to populate.

**First, set up activity thresholds** in your Bookbuilder settings.&#x20;

1. Go to Bookbuilder -> Settings
2. Select "Rep Activities and Thresholds" and click the "Configure activity thresholds" button
3. Set up at least one activity threshold. Each threshold needs a name so it's easy to recognize in a drop-down later, as well as the included activities (such as email, call, etc), and a number of activities, contacts engaged, and time period.&#x20;

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2FDLx0fpx4KnL7sQuAscoS%2FScreenshot%202025-08-05%20at%209.01.44%E2%80%AFAM.png?alt=media&#x26;token=aebfaa44-8120-486d-b057-fd705903079c" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Think about what the minimum engagement should be to truly "work" an account, and if that differs for the kind of rep, target book, or accounts being worked. You may have different thresholds for how you expect a mid-market AE to work an account compared to a SMB SDR. Or maybe you have the same basic criteria across rep and book type; that's okay too.
{% endhint %}

**Second, add the new threshold to a target book**.&#x20;

1. Go to Bookbuilder -> Target Books
2. Click on the name of a target book
3. Select "View Configuration" at the top, then click the "Edit" link
4. Select an activity threshold from the "Activity Threshold" dropdown menu in the top right. Click Save.

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2FyvPkYnNV9cDpHdgYaIRl%2FScreenshot%202025-08-05%20at%209.03.17%E2%80%AFAM.png?alt=media&#x26;token=43af4302-c2f8-4bd7-bc16-46c952940fe6" alt=""><figcaption></figcaption></figure>

### Interpreting Activity Threshold Metrics

After you configure these two pieces, the new thresholds reporting will populate in [Pipeline Overview](https://docs.gradient.works/kb/analytics/pipeline-overview), [Reps Listing](https://docs.gradient.works/kb/analytics/reps-report), and individual [Rep Detail Reports](https://docs.gradient.works/kb/analytics/reps-report/rep-detail-report).&#x20;

#### Reps Listing

If you go to the Reps Listing (Reports -> Reps), you'll see the coverage overview chart is now red, yellow and green to show activity.&#x20;

* **Green = Healthy**. Green accounts have met or exceeded the activity threshold for the target book in the report period.
* **Yellow = At Risk**. Yellow accounts have been touched (at least one activity in the report period), but not worked enough to meet the activity threshold.
* **Red = Needs Attention**. Red accounts have not been touched during the report period. That means 0 activities.

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2FCnriBH859N8RtjQsm0Bt%2FScreenshot%202025-08-05%20at%209.38.54%E2%80%AFAM.png?alt=media&#x26;token=7f98334e-60c3-4dc8-8c90-4df95a893f50" alt=""><figcaption></figcaption></figure>

You'll also see updated metrics throughout Bookbuilder reporting. We now show touched accounts and worked accounts. There's a slight difference between a "*touched*" account and a "*worked*" one.

* **Touched accounts**: Accounts with at least 1 activity in the report period
* **Worked accounts**: Accounts that meet or exceed the activity threshold for that target book

All worked accounts have been touched, but not all touched accounts have been fully worked.&#x20;

#### Rep Detail Report

The individual Rep Report now includes the red, yellow and green activity breakdowns for each account, as well as updated "touched" and "worked" metrics.

The Engagement module includes 4 metrics, including 2 that are related to activity thresholds:&#x20;

* **Owned Accounts**: The total number of accounts under ownership by this rep
* **Touched Accounts**: The number of accounts this rep owns with at least one activity during the report period
* **Worked Accounts**: The number of accounts this rep owns that have met the relevant activity threshold during the report period
* **Worked Rate**: The percentage of worked accounts out of the total accounts owned by that rep (Worked Accounts / Owned Accounts)

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2FZOWpBFNRzAG2syafK5lQ%2FScreenshot%202025-08-05%20at%209.40.29%E2%80%AFAM.png?alt=media&#x26;token=64e96a9a-0412-4e4f-b707-c072c7c8dfba" alt="" width="375"><figcaption></figcaption></figure>

The Currently Owned Accounts table now includes a Coverage column that shows red/yellow/green indicators for every account under that rep's ownership. You can view all owned accounts, or click the Healthy, At Risk, Needs Attention headings to view just the accounts in each category.&#x20;

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2F8mstdMWJFPNMNw6jFqfu%2FScreenshot%202025-08-05%20at%209.05.53%E2%80%AFAM.png?alt=media&#x26;token=876cbab0-bfbc-4708-805c-9c44caef472c" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Use these color codes in coaching sessions to help reps see where they should focus their time. You can customize the table to include other data from the account record. Add in relevant account scores and sort the table based on score. Reps should spend more time with high-scoring accounts that are currently yellow and red.&#x20;
{% endhint %}

#### Pipeline Overview

The Pipeline Overview dashboard includes a few metrics based on activity thresholds.&#x20;

The Worked Accounts chart now shows worked accounts according to your activity thresholds. That means the totals that appear in that chart are only the accounts that have met or exceeded an activity threshold during this report period.

The Rep Leaderboard shows worked accounts as well. To see which accounts have gone unworked or barely worked (aka "touched"), drill into the rep reports.

<figure><img src="https://2378295204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUYXbv7c6RsZzQ00WCDTM%2Fuploads%2FypMFEIcDhGDG3voO6Dvh%2FScreenshot%202025-08-05%20at%209.47.55%E2%80%AFAM.png?alt=media&#x26;token=851e7140-646b-40dd-980a-883047a77715" alt=""><figcaption></figcaption></figure>


---

# 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.gradient.works/kb/analytics/activity-thresholds.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.