> For the complete documentation index, see [llms.txt](https://docs.limio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.limio.com/salesforce/setting-up/additional-config/subscription-actions-rules.md).

# Subscription Actions

**LFS version**: requires v12.42 or later

When a subscription is selected in the **Manage Subscriptions flow**, on the next screen users see a **list of available actions** based on the subscription's attributes. This subscription actions list is defined on the backend by a standard Limio Apex class.

This article describes a new tool - **Subscription Actions Rule Rules Builder** - which allows defining custom rules to show different actions for different subscription criteria.

{% hint style="info" %}
**Each rule has two lists.** Fill in **Actions List** for Zuora and **Actions List (Stripe)** for Stripe. The package uses the list for your Payment Provider. If that list is empty, the agent sees no actions for subscriptions that match the rule. See [Payment Providers](/salesforce/setting-up/detailed-salesforce-setup/payment-providers.md).
{% endhint %}

***

### Subscription Actions Rule Rules Builder is based on a new custom object called **Subscription Actions Rule.**

* Navigate to the **Subscription Actions Rule** tab from the App Launcher or from the related tabs list in the Limio Console and create a new rule record.
* Define subscriptions criteria on the left side of the page, and click Save.
* Select the allowed actions on the right, and Save it.<br>

  <figure><img src="https://284256719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUgE12kxtw8dDbuEZGzbI%2Fuploads%2Fgit-blob-b601e337426e16172eda4cd25bcc9c975febaac8%2Fimage%20(150).png?alt=media" alt=""><figcaption></figcaption></figure>

**Subscription Criteria** section is where you can set up entry criteria to check against a subscription.

It includes some subscription level attributes (like Status, Term details, Product etc.) and Subscription Offer's Criteria with all the standard and custom attributes defined in the Limio template:<br>

<figure><img src="https://284256719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUgE12kxtw8dDbuEZGzbI%2Fuploads%2Fgit-blob-6ee3a035ae00d6cdec142999fc3d248f08c62cbd%2Fimage%20(151).png?alt=media" alt=""><figcaption></figcaption></figure>

And action Selector on the right side of the page<br>

<figure><img src="https://284256719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUgE12kxtw8dDbuEZGzbI%2Fuploads%2Fgit-blob-3fcfa2cf69c54c7fe923b6769b8b4305d0cae762%2Fimage%20(152).png?alt=media" alt=""><figcaption></figcaption></figure>

* When a user selects a subscription in the **Manage Subscriptions** flow and this subscription **matches the rule's subscription criteria**, only specified actions will be available.<br>

  <figure><img src="https://284256719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUgE12kxtw8dDbuEZGzbI%2Fuploads%2Fgit-blob-df3c2a2449a6c79213ebb860251aebe95819aded%2Fimage%20(153).png?alt=media" alt=""><figcaption></figcaption></figure>
* If the subscription does not match any of the rules, displayed actions will default to the existing logic described in [this guide](https://docs.limio.com/salesforce/setting-up/additional-config/subscription-actions-rules/override-subscription-actions).<br>

  <figure><img src="https://284256719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUgE12kxtw8dDbuEZGzbI%2Fuploads%2Fgit-blob-7ac9410951345c4a55968679aa37b82c11a02e5f%2Fimage%20(154).png?alt=media" alt=""><figcaption></figcaption></figure>

### Tips

1\. Manage Subscriptions flow triggers **Get Subscription Actions** Apex class and passes down properties from the selected subscription record. Make sure that the following properties are included and mapped correctly:

```
- endDate
- external
- hasDelivery
- isAutoRenewable
- isGift
- isGiftRefundable
- offerPath
- offerProducts
- offerTermLength
- offerTermType
- status
```

### Note

If there are no records of the **Subscription Actions Rule** type available, Limio will fall back on its [internal logic for surfacing actions](https://docs.limio.com/salesforce/setting-up/additional-config/subscription-actions-rules/override-subscription-actions). Please review this logic to understand how actions are determined in the absence of explicit rules.

#### Related articles: <a href="#h_01hy0kr8vnhaw9psw67241zk55" id="h_01hy0kr8vnhaw9psw67241zk55"></a>

[Override Actions](/salesforce/setting-up/additional-config/subscription-actions-rules/override-subscription-actions.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.limio.com/salesforce/setting-up/additional-config/subscription-actions-rules.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
