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

# Manage subscriptions

> Subscriptions management from your FunnelFox Billing dashboard. Handle upgrades, downgrades, pauses, and grace periods.

Handle subscription changes directly in your FunnelFox Billing dashboard for both, subscriptions purchased in FunnelFox or in your custom funnels.

<Tip>You can also use [FunnelFox Billing API](/develop/api-billing) for managing subscriptions crated through your custom funnels.</Tip>

## Subscription management

To modify your FunnelFox Billing subscriptions:

1. Go to the **Support Tool** page in your FunnelFox Billing dashboard.
2. Search for a user or click on the User UUID under **Latest payments**.
3. Make your changes in the **Subscriptions** section.

<Frame>
  <img src="https://mintcdn.com/funnelfox/vXeS9eK9CycCPjRE/assets/billing-manage-subs.gif?s=607b32a32dec0553288ca81951e1e465" width="1920" height="880" data-path="assets/billing-manage-subs.gif" />
</Frame>

From here, you can:

* Unsubscribe
* Pause and resume
* Add discount
* Defer
* Migrate

### Unsubscribe

Click **Unsubscribe** under the selected subscription, if you want to disable its auto-renewal.

Premium access remains active until the end of the current paid period, then becomes deactivated.

<Frame>
  <img src="https://mintcdn.com/funnelfox/Ya0k4Wv9LIaQV8rv/assets/unsubscribe.png?fit=max&auto=format&n=Ya0k4Wv9LIaQV8rv&q=85&s=47ea29c1b5c6bbf4c0a839885c3ca8b5" width="1920" height="879" data-path="assets/unsubscribe.png" />
</Frame>

### Pause and resume

To temporarily delay future charges:

1. Enter the pause details:
   * **Duration** (days)
   * **Pause reason** (optional)
   * **Comment** (optional)
2. Click **Pause**.

Premium access is suspended for the pause duration. The subscription
resumes automatically after the set period, or you can resume it
manually via the API.

<Frame>
  <img src="https://mintcdn.com/funnelfox/vXeS9eK9CycCPjRE/assets/billing-pause.png?fit=max&auto=format&n=vXeS9eK9CycCPjRE&q=85&s=a448380ce4d36d90d9db0aa2e5cb4af3" width="1920" height="879" data-path="assets/billing-pause.png" />
</Frame>

When you pause subscriptions:

* `next_check_at` indicates the datetime when the subscription will auto-resume.
  When the pause is persistent (no end date), this value is `null` and
  the subscription must be resumed manually via the API.
* `unused_premium_after_pause` shows how long Premium access will remain
  available after the subscription resumes. This attribute is not
  currently included in webhook payloads.

### Add discount

After a subscription is purchased, you can apply discounts to future payments:

1. Enter the discount details:
   * **Percentage**: Discount amount based on iteration price.
   * **Number of iterations**: How many billing cycles the discount applies to.
   * **Reason** (optional)
   * **Comment** (optional)
2. Click **Add discount**.

For example, set a 30% discount on 12 future payments, or a 50% discount on just the next two payments.

<Frame>
  <img src="https://mintcdn.com/funnelfox/vXeS9eK9CycCPjRE/assets/billing-add-discount.png?fit=max&auto=format&n=vXeS9eK9CycCPjRE&q=85&s=45a3eaa21a83969dc6134bb9d67af3e0" width="1920" height="879" data-path="assets/billing-add-discount.png" />
</Frame>

### Defer

You can postpone the next charge date:

1. Enter the deferral details:
   * **Duration** (days)
   * **Pause reason** (optional)
   * **Comment** (optional)
2. Click **Defer**.

This is useful when a user could not use the app and you want to compensate them for that time.

The next payment date is pushed forward, giving the user free access for a set period. This helps maintain customer loyalty without issuing refunds or manually extending subscriptions.

<Frame>
  <img src="https://mintcdn.com/funnelfox/vXeS9eK9CycCPjRE/assets/billing-defer.png?fit=max&auto=format&n=vXeS9eK9CycCPjRE&q=85&s=38d9a276fb8f3122ac0ddcc7a8f9e245" width="1920" height="879" data-path="assets/billing-defer.png" />
</Frame>

## Update user email

<Tip>Learn how FunnelFox Billing [stores customer emails](/billing/payments-management#email) from purchases.</Tip>

Along with subscription details changes, you can also update customer email.

1. Go to the User Information section of the **Support Tool** page in your FunnelFox Billing dashboard.
2. Enter a new valid email address.
3. Click **Update**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/vXeS9eK9CycCPjRE/assets/billing-update-email.png?fit=max&auto=format&n=vXeS9eK9CycCPjRE&q=85&s=6917e548f9afc94fedbc270580b94e1a" width="1920" height="879" data-path="assets/billing-update-email.png" />
</Frame>

An email is valid only if it passes all of the following validation rules:

* Must be a properly formatted email address (has a local part, an `@` sign, and a valid domain).

* Reject if the email ends with `example@example.com`.

* Reject if the email starts with `FIXME@`.

## Next steps

* [Learn how to migrate a customer’s subscription to a new plan](/billing/subscription-migration-billing)
