> For the complete documentation index, see [llms.txt](https://help.smartrr.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartrr.com/docs/support/admin-portal/what-is-retention/cancel-reasons-and-actions.md).

# Cancel Reasons & Actions

Offer additional discounts or actions to help prevent customers from churning, and capture the feedback of customers who still decide to end their subscription.

## 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="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FboNmD65DRlLv9EtmP0hb%2FScreenshot%202024-04-10%20at%201.02.54%E2%80%AFPM.png?alt=media&amp;token=75637bd5-d00a-43a0-840f-cac409d33de2" alt="The retention page, showing actions that customers decided to take (eg. updating their frequency) instead of canceling, and the cancel reasons in effect and their set actions."><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="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FIFjlvS3aJtoLwcJ4tGPH%2FScreenshot%202024-04-10%20at%201.04.16%E2%80%AFPM.png?alt=media&amp;token=0d45bb2c-6b4f-4b11-a781-ec3c23675278" alt="The cancel option highlighted in the subscription card in the customer portal."><figcaption></figcaption></figure>

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2F1t2ho4vPkEj7jLL6sjar%2FScreenshot%202024-04-10%20at%201.05.27%E2%80%AFPM.png?alt=media&amp;token=36299298-b33f-4983-b21f-1711219a5182" alt="Screenshot of the cancel reasons displayed to the customer in the customer portal."><figcaption></figcaption></figure>

### Retention Actions

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FW90WLhFdha9YsVue5Cu9%2Fret-action.png?alt=media&amp;token=30669882-3d8e-47c5-a562-24e85394a611" alt="Retention actions in the admin portal, on the retention menu page."><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="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fx5zQDS9zMcARFtLvbMDx%2FScreen%20Shot%202022-07-18%20at%203.16.50%20PM.png?alt=media&amp;token=adc85ec7-8808-4263-8759-08d75fef0e4a" alt="If customers add a note with their cancellation reason, this is denoted by a &#x22;dialogue cloud&#x22; that appears next to their selected reason in the retention summary table. Hovering over this icon will display the full note left by the customer. The notes are also available in an export of the retention report."><figcaption></figcaption></figure>

## Pause Reasons

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fkjr8BLL7cjgEWaL5Rjzj%2Fpause-reasons.gif?alt=media&amp;token=b2bf775f-6d54-4e7a-94da-961563c16dfe" alt="Cancel and Pause reasons can be toggled on or off. Simply toggle their status to make them go into effect for your customers."><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="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fe8higoO2YMKyiXWVYnai%2FScreenshot%202023-02-09%20at%2016.54.43.png?alt=media&amp;token=dbeff527-9b49-4e06-848e-4422186ad809" alt="Screenshot of the headers/columns of the retention summary table."><figcaption></figcaption></figure>

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

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FbEGtyAyhWwJ1Lc7FQxi2%2Fimage.png?alt=media&amp;token=25db7cc8-50d7-42af-97ab-3e0971f6f67e" alt="Example of a populated retention table, showing the cancellation reasons, customer notes icon, date of cancellation and the action that was taken."><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       |

***

*Related articles:*

* [*What is Retention?*](/docs/support/admin-portal/what-is-retention.md)
* [*What is the Cancellation Intercept?*](/docs/support/admin-portal/what-is-retention/what-is-the-cancellation-intercept.md)


---

# 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://help.smartrr.com/docs/support/admin-portal/what-is-retention/cancel-reasons-and-actions.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.
