# Retention

Last updated: May 14, 2025

## Overview

Brands on our Grow and Excel plans have access to a **Retention**— a feature allows merchants to gain insight on why customers pause and cancel their subscriptions.

<figure><img src="/files/JAHNVCvFfrQrfimORpqD" alt=""><figcaption></figcaption></figure>

## Cancellation Reasons

Brands can add up to <mark style="color:green;">**eight**</mark> reasons to display in your customers’ account portal alongside a text field for your customers to provide more information. The following reasons show up by default:&#x20;

<table><thead><tr><th>Smartrr default cancellation reasons</th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><em>Product is too expensive</em></td><td></td><td></td></tr><tr><td><em>I have more than I need</em></td><td></td><td></td></tr><tr><td><em>I need it sooner</em></td><td></td><td></td></tr><tr><td><em>I want to try a different product</em></td><td></td><td></td></tr><tr><td><em>I don’t love the product</em></td><td></td><td></td></tr><tr><td><em>I’m moving and need to change my address</em></td><td></td><td></td></tr><tr><td><em>Other</em></td><td></td><td></td></tr></tbody></table>

<figure><img src="/files/b1unaMM5vl4tPiElNA7v" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/MEzmu45enPhr2JGpmGUq" alt=""><figcaption></figcaption></figure>

### Retention Actions

<figure><img src="/files/fMcWUGXw0weFTXuBujEo" alt=""><figcaption></figcaption></figure>

Each cancellation reason can be assigned an optional **retention action** that will prompt the customer with an additional module before they cancel:&#x20;

<table><thead><tr><th width="246">Retention action</th><th>Customer will be prompted...</th></tr></thead><tbody><tr><td>Gift</td><td><em>"Would you like to gift your next order to a friend?"</em></td></tr><tr><td>Swap</td><td><em>"Would you like to swap an item in your next order?"</em></td></tr><tr><td>Change Date</td><td><em>"Would you like to change the date of your next subscription order?"</em></td></tr><tr><td>Discount</td><td><em>"Would you like an additional X% off your next order?"</em></td></tr><tr><td>Frequency Update</td><td><em>"Would you like to edit the frequency of your orders?"</em></td></tr><tr><td>Skip</td><td><em>"Would you like to skip your next order?"</em></td></tr><tr><td>Change Address</td><td><em>"Would you like to edit the delivery address for your subscription?"</em></td></tr></tbody></table>

### Prompts

Prompts, when set to **YES**, provide an additional box for for the customer to provide more information on why they are trying to cancel. If a customer volunteers information it will appear on hover over the chat icon in the table of retention results.&#x20;

<figure><img src="/files/zlpB2tZKG0sd3e9j3hej" alt=""><figcaption></figcaption></figure>

## Pause Reasons

<figure><img src="/files/lYzmTHuHiUORbf5lNE9l" alt=""><figcaption></figcaption></figure>

Brands can add up to <mark style="color:green;">**eight**</mark> reasons to display in your customers’ account portal alongside a text field for your customers to provide more information.&#x20;

### Retention Table

Brands can see a full breakdown of **Cancellation attempts by customer** and **Cancellation reason summary**, **Pause attempts by customer** and **Pause reason summary**, or quickly export all data to CSV.

<figure><img src="/files/gF6Lb4y0lspneT8W1IyN" alt=""><figcaption></figcaption></figure>

The retention table shows the cancelation reason, date of the cancelation and the action taken (retention action):

<figure><img src="/files/evtw3HhYJmfX2CZBAIYg" alt=""><figcaption></figcaption></figure>

If a customer decided to opt-in for the retention action, this will reflect in the retention table. One of the below will show up under the "Action Taken" column based on the customer's choice:

| Action Taken Statuses |
| --------------------- |
| Canceled              |
| Swapped               |
| Gifted                |
| Discount              |
| Frequency updated     |
| Date changed          |
| Skipped               |
| Address updated       |


---

# 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://help.smartrr.com/docs/support/admin-portal/retention.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.
