> For the complete documentation index, see [llms.txt](https://docs.hackle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackle.io/en/ab-test/create-and-configure/set-abretention-metric.md).

# Create Retention

{% hint style="warning" %}
The Data Analytics tab is only accessible in the Production Environment.
{% endhint %}

{% stepper %}
{% step %}

### Select Create Retention

Select **Create Retention** in the upper right of the Retention tab.\
You can configure up to 5 retention analyses.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-783b8a494358f4d8713b78fc7e360a27c3849e2a%2F8062b11-create_retention_02_1753f176404fad66.png?alt=media)
{% endstep %}

{% step %}

### Enter the retention name and description

Enter the retention name and description.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-4126f09950ef38a172f74e42b9542e2af8a1f0f4%2F98fb468-create_retention_kr_783019c07487a8a8.png?alt=media)
{% endstep %}

{% step %}

### Configure the start event

The start event is the criteria for a user's first behavior in the retention analysis.

* **First A/B Test Exposure**: Includes all unique users exposed to the A/B Test. Users are counted even if they take no additional action. For repeated exposures, only the first exposure is counted.
* **Add event**: Analyzes users who triggered a specific event after their first A/B Test exposure.
  * Filters can be applied only to the event you added.
  * This feature is available from the Pro plan and above.
    {% endstep %}

{% step %}

### Configure the goal event

The goal event is the behavioral criteria for identifying retained users among the target users.

* You can apply filters to the goal event.
* You can select **Any Event**. Any Event refers to all active events sent to Hackle. Use it to measure the overall service revisit rate.
  {% endstep %}

{% step %}

### Check the retention user count

You can check the rate at which users who triggered the start event also trigger the goal event within a certain period.

The configuration below means the retention of users exposed to the A/B Test who triggered Any Event. The diagram shows the retention user counts.
{% endstep %}
{% endstepper %}

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-a415c7f183d6278e1641968a8d6ba6bffbc41a14%2Fb57eb05-Retention_docs_02_33ad56af74005a9b.png?alt=media)


---

# 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 dynamically by asking a question.

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

```
GET https://docs.hackle.io/en/ab-test/create-and-configure/set-abretention-metric.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.