> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appreval.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscription plans: frequency, price and activation

> How to create plan groups, tie them to variants, choose between a percentage discount and a fixed price, and apply a price change to existing subscribers.

Plans define how often you charge and at what price. A product shows the subscription buy box on its page **only when it has at least one active plan**.

## The plan type

The first thing you choose when creating a plan is its **type**, and it can't be changed afterwards:

| Type                                     | What it's for                                                                                                                                                  |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Suscribí y Ahorrá** (Subscribe & Save) | Products with a recurring charge — the classic plan: you tie variants and define the discount or the fixed price                                               |
| **Caja dinámica (Dynamic Box)**          | The customer builds their box out of eligible products — the plan defines the frequency and a **% discount off the list price** of whatever the customer picks |

A dynamic-box plan **carries no tied products**: the eligible products, the sizes and the volume discounts are defined on the box, in the [Boxes](/en/merchant/boxes) section. For the same reason, it has no "Apply to subscribers" either: each box's price is recalculated when it's edited. The discount accepts 0 to 99 (0 is valid — the box can discount through its own tiers alone), and when you edit it, it applies to new purchases and to each box's next edit.

In the list, each group carries its type badge: **Caja dinámica** or **Suscribí y Ahorrá**.

## Plan groups

The unit you work with is the **plan group**: a title, an interval and a pricing mode, to which you then tie as many variants as you like.

The advantage is that you define the terms once. If you have twenty products with a monthly subscription at 15% off, that's one group with twenty variants tied to it — not twenty separate configurations.

### The two pricing modes

| Mode            | How it works                                                                        | When it fits                                                                               |
| --------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Percentage**  | A % discount off each product's current price, resolved at the moment of the charge | Catalogs with different prices, or when you want the discount to follow list-price changes |
| **Fixed price** | A single absolute price for every tied variant                                      | Boxes or bundles where all the products are worth the same within the plan                 |

<Warning>
  **The interval can't be changed once the group is created.** If you picked the wrong frequency, you have to create a new group with the right one and move the variants over. It's a constraint of how mandates are modeled in Mercado Pago.
</Warning>

***

## Creating a plan

<Steps>
  <Step title="Open Plans">
    From your Shopify admin, go to **Apps → Reval → Plans**.
  </Step>

  <Step title="Create the group">
    Define the title, the interval (number + unit: days, weeks or months) and the pricing mode — percentage discount or fixed price. The title is internal, but the subscriber sees it as the debit's description in Mercado Pago.
  </Step>

  <Step title="Choose how it's shown in the store (optional)">
    The **Name on the product page** field controls the plan selector's text in the buy box. Left empty, the frequency is shown (e.g. "Monthly"); filled in, your text is shown (e.g. "Coffee Club") with the frequency still visible underneath — the customer never subscribes without seeing how often they'll be charged.
  </Step>

  <Step title="Tie the variants">
    Add the product variants that will be offered on these terms. Each tied variant gets its own price template in Mercado Pago.
  </Step>

  <Step title="Check on the storefront">
    Open the page of one of those products: the buy box should already show the subscription option.
  </Step>
</Steps>

<Note>
  Weeks are a display unit: Mercado Pago only understands days and months, so a weekly frequency is converted to days by multiplying by seven. The behavior is the same.
</Note>

***

## Cycle limits (minimums and maximums)

When creating or editing a plan you can define two optional limits, both expressed as a number of charges:

* **Minimum cycles** — a commitment period. Until that number of charges is completed, the customer **can't pause or cancel from their portal** (they see the reason and how many are left). You can always cancel from the admin, with no restriction.
* **Maximum cycles** — a defined duration. After charge number N, the subscription **stops charging on its own**: Reval cancels the mandate in Mercado Pago and emits the "Subscription ended" event to Klaviyo / Shopify Flow for the closing email. The status stays **Active** (the same criterion as Skio): the ending is communicated with the "Cycles completed — no further charges" notice in the admin and in the customer portal, and it's recorded in the history.

The product's buy box shows the commitment before subscribing ("Minimum commitment of X deliveries", "Subscription for a maximum of Y deliveries"). Empty = no limit, and nothing is shown.

<Note>
  The limits are stored on the plan: editing them also applies to that plan's existing subscriptions, both for the pause/cancel block and for the automatic ending.
</Note>

***

## Changing a plan's price

This is the part that causes the most confusion, so it's worth being explicit:

<Warning>
  **Editing a group's price does NOT change what your current subscribers pay.** It only changes what will be paid by those who subscribe from now on.
</Warning>

For the change to reach existing subscribers you have to run **Apply to subscribers** from the group. That action walks through that group's subscriptions and updates the mandate amount in Mercado Pago, taking effect **from the next cycle** — a charge that already happened is never touched.

Every change is recorded in the subscription's price history.

<Tip>
  The separation is deliberate: it lets you fix a badly configured plan without changing anyone's price, and decide separately when to pass an increase on to your existing base. It's also worth notifying the customer before raising their amount — in several markets it's a legal obligation, and in all of them it's good practice.
</Tip>

***

## Managing existing plans

### Editing a group

You can change the title, the name on the product page and the pricing terms. **Not the interval.** Price changes are written to every tied variant, but remember they don't reach subscribers until you use "Apply to subscribers".

<Tip>
  If a product has **more than one plan**, which one comes preselected when the product page opens is chosen per product in [Products](/en/merchant/products). By default it's the one with the shortest frequency.
</Tip>

### Removing a variant

Takes that variant out of the group. The product stops offering a subscription in the buy box if it has no other active plan left. **Existing subscriptions for that variant keep being charged normally.**

### Archiving a group

Plans aren't deleted, they're archived. The group stops being offered on the storefront and disappears from the list, which by default shows only active ones.

<Note>
  Archiving **does not cancel or pause** any subscription. Anyone already subscribed on that plan continues their normal cycle. If you need to act on them, go to [Tools](/en/merchant/bulk-operations).
</Note>

***

## If a product doesn't show the subscription option

Check in this order:

1. That the variant is tied to an **active** plan group
2. That the group isn't archived
3. That the buy box block is present in the product's theme

You can resolve the first two from this screen. The third requires touching the theme — get in touch with us.
