> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/subscriptions/storefront-and-accounts/the-customer-subscription-dashboard-a-tour.md).

# The customer subscription dashboard: a tour

Every action your customers see on their account-page subscription dashboard, including how the Manage Subscription menu changes by status.

Every customer with at least one subscription contract gets a dashboard inside their storefront account. This is where they manage their subscriptions on their own, skip a delivery, swap a product, update their card, pause, cancel, and more.

This article is a reference for what your customers see and what they can do at each step.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FDZzibamxewvgqIzqBeOY%2FScreenshot%202026-09-30%20at%204.59.05%E2%80%AFPM.png?alt=media&amp;token=d9a70517-3d36-4743-8f7d-5261ff8d938c" alt=""><figcaption></figcaption></figure>

#### Where customers find their subscriptions

In the customer's storefront account area, there's a **Subscription** tab in the navigation. Clicking it opens **My Subscriptions**, a list of every subscription contract they have, each shown as a card.

The dashboard is identical in functionality across both legacy and new Shopify customer accounts. Only the styling differs. For styling configuration, see:

* [Configuring the Customer Subscriptions widget (legacy customer accounts)](https://docs.roadmap.so/subscriptions/storefront-and-accounts/configuring-the-customer-subscriptions-widget-legacy-customer-accounts.md)
* [Configuring the Subscription Management block (new customer accounts)](https://docs.roadmap.so/subscriptions/storefront-and-accounts/configuring-the-subscription-management-block-new-customer-accounts.md)

#### What's on each card

Each subscription card shows:

* A status pill, `Active`, `Paused`, or `Failed`
* The cadence and shipping address, for example `Delivered every 2 weeks to: Thom Sussex, 36 Karaka Street, Auckland 1010`
* The next two upcoming shipment and charge dates
* The products, with the card total beneath them
* A **Manage Subscription** dropdown button that opens the action menu

#### The product controls on the card

The product list is interactive, separate from the **Manage Subscription** menu.

Each subscription product has a quantity stepper and a **Swap product** link. A **Remove** link appears **only when the contract holds more than one subscription product**. With a single product there is nothing left to bill, so removal is blocked and the link is hidden. To end a one-product subscription the customer pauses or cancels instead.

One-off items are listed with a **Next order only** badge and can always be removed, whatever else is on the contract.

Where the plan discounts one-off products, the line also carries a badge showing the discount, the discounted price against the struck-through original, and the offer's name underneath. The subscription products on the same card keep their own subscription discount, so a card can show two different savings at once. See [Offer one-off products at a discount](https://docs.roadmap.so/subscriptions/getting-started/offer-one-off-products-at-a-discount.md).

Below the list, **+ Add product to order** lets the customer add either a permanent subscription product or a one-off for the next order. See [Adjusting an upcoming subscription order](https://docs.roadmap.so/subscriptions/managing-subscriptions/adjusting-an-upcoming-subscription-order.md) for that flow.

#### The Manage Subscription menu

What's available in the dropdown depends on the contract's status. The dashboard hides actions that aren't applicable so customers don't try them and hit an error.

**When the contract is Active**

All ten actions are available:

| Action                    | What it does                                                                                  |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| Order now                 | Charges the customer immediately and creates an extra order on top of the recurring schedule. |
| Skip next delivery        | Defers the next charge to the cycle after. The recurring schedule continues normally.         |
| Reschedule                | Moves the next billing date to a date the customer picks.                                     |
| Change delivery frequency | Switches between cadences offered by the plan, for example monthly to every 2 months.         |
| Edit shipping address     | Updates the address future orders ship to, see **Address restrictions** below.                |
| Swap Products             | Changes products on the contract, limited to the products on the same plan.                   |
| Redeem loyalty points     | Applies a loyalty discount to the next billing cycle.                                         |
| Update payment method     | Sends the customer a Shopify-native email with a link to update their card.                   |
| Pause subscription        | Stops billing temporarily. Reactivation by either side resumes it.                            |
| Cancel subscription       | Stops billing permanently. The customer cannot reactivate.                                    |

For deeper detail on each action, see [Manually charging a subscription (Order Now)](https://docs.roadmap.so/subscriptions/managing-subscriptions/manually-charging-a-subscription-order-now.md), [Loyalty points × subscriptions](https://docs.roadmap.so/subscriptions/storefront-and-accounts/loyalty-points-subscriptions.md), and [Pausing, canceling, and reactivating subscriptions](https://docs.roadmap.so/subscriptions/managing-subscriptions/pausing-canceling-and-reactivating-subscriptions.md).

**When the contract is Paused or Failed**

The dropdown collapses to four actions:

| Action                  | What it does                                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Edit Shipping Address   | Updates the address attached to the contract, ready for when billing resumes.                                                                                |
| Update Payment Method   | Sends the Shopify-native update email so the customer can fix their card before reactivating.                                                                |
| Reactivate Subscription | Restarts billing. The customer picks a new delivery date and the schedule aligns to it. For Failed contracts this requires a working payment method on file. |
| Cancel Subscription     | Permanently cancels the contract.                                                                                                                            |

Active-only actions like **Order now**, **Skip**, **Reschedule**, **Change frequency**, **Swap Products**, and **Redeem loyalty points** are hidden, they don't apply when billing isn't running.

For Failed contracts specifically, customers usually need merchant help, see [Updating a customer's payment method](https://docs.roadmap.so/subscriptions/managing-subscriptions/updating-a-customers-payment-method.md) and [Pausing, canceling, and reactivating subscriptions](https://docs.roadmap.so/subscriptions/managing-subscriptions/pausing-canceling-and-reactivating-subscriptions.md).

#### Reactivating, customer-side

**Reactivate Subscription** is not a one-click action. It opens a modal with a single field, **New delivery date**, and confirms that *the subscription will be reactivated and the billing schedule will be aligned to the selected date*.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FqHKnbk3fOBEvcO66AQ4v%2FScreenshot%202026-09-30%20at%204.59.57%E2%80%AFPM.png?alt=media&amp;token=199e61c5-0831-4ca5-94b4-9b80a8092753" alt="" width="375"><figcaption></figcaption></figure>

The date the customer picks becomes the next billing date, and the delivery frequency counts forward from there. The contract does not resume its old schedule.

The same modal appears whether the contract is Paused or Failed, and merchants see it too when they reactivate from the admin. See [Pausing, canceling, and reactivating subscriptions](https://docs.roadmap.so/subscriptions/managing-subscriptions/pausing-canceling-and-reactivating-subscriptions.md).

#### Address restrictions

When customers use **Edit Shipping Address**, they pick from their saved addresses in the country their subscription ships to now, or add a new one. Addresses in other countries aren't shown, and the country can't be changed when they add or edit an address. The full picker is covered in [Changing a subscription's shipping address](https://docs.roadmap.so/subscriptions/managing-subscriptions/changing-a-subscriptions-shipping-address.md).

This protects the customer from picking a country where the product isn't available, which would otherwise cause billing or fulfillment failures.

If a customer needs to move to another country, for example they relocated internationally, you can change the address on their behalf from the Roadmap admin: open the contract, go to the **Shipping address** card, and use **Edit**. The admin can pick an address in any country, for moves where you've confirmed the product is available at the new destination.

**When an address won't save**

If the new address doesn't pass validation, the dashboard keeps the customer on their current address and shows a banner headed **Couldn't update shipping address**, naming the reason and what to do about it:

| Reason                                           | What the customer needs to change                                                                             |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| The postal code doesn't match the city or region | Correct whichever of the three is wrong so they agree                                                         |
| The phone number is missing, or isn't valid      | Add a valid phone number. If your checkout settings make the shipping phone required, it is required here too |
| The address is missing a state or region         | Choose the state or region                                                                                    |
| The address is missing a last name               | Add a last name                                                                                               |
| The subscription doesn't ship to that country    | Choose an address in the country the subscription ships to, or ask you to move it, as described above         |

Anything that doesn't fall into one of those shows a general "something went wrong" message and asks them to try again or contact you, rather than exposing a raw error.

Every failed attempt is written to the contract's Timeline with its reason, so you can see what the customer ran into without asking them to reproduce it. See [The Subscription Activity Timeline](https://docs.roadmap.so/subscriptions/managing-subscriptions/the-subscription-activity-timeline.md).

#### Swap restrictions

Products on an active subscription can only be swapped for other products set up on the same subscription plan. The plan's **Subscription Products** is the swap pool, and nothing outside it is offered.

That makes the plan your control over how much freedom customers get. Put a customer on a plan holding only the multi-vitamin variants and they can move between those and nothing else. Put them on a plan holding everything and they can swap freely.

A swapped-in product is charged at the subscription price, so the plan's recurring discount carries across to it. The one-off price the same product might carry in the **Next order only** picker does not apply to a swap.

For how to structure plans for swap behavior, see [How to set up a subscription plan](https://docs.roadmap.so/subscriptions/getting-started/how-to-set-up-a-subscription-plan.md).

#### Update payment method, customer-side

When customers use **Update payment method**, the dashboard:

1. Shows a confirmation dialog: `Send email to [their email] with instructions to update the payment method.`
2. On confirmation, sends them a Shopify-native email with a secure update link.
3. The customer follows the link and updates their card via Shopify's customer-account flow.

This is one of two payment-recapture mechanisms in Roadmap, the customer-driven Shopify-native flow. The merchant-only ShopPay `$1` checkout flow is admin-side, not exposed to customers. See [Updating a customer's payment method](https://docs.roadmap.so/subscriptions/managing-subscriptions/updating-a-customers-payment-method.md).

#### What customers don't see

Customers don't see the Roadmap admin, the Activity Timeline, the Customer Subscription History card, or any other merchants' contracts. Their dashboard is scoped strictly to their own subscriptions.

They also never see the eligibility behind a one-off offer. Your tags, tiers and offer rules stay in the admin; the customer only ever sees the price and the label you wrote.

A few merchant-only actions don't appear in the customer dropdown either:

* **Mark as Failed**, an admin-only override
* **Bulk operations**, exporting, bulk emailing, bulk payment-method updates

#### Troubleshooting

**A customer says they can't see the Subscriptions tab in their account**

* Confirm the customer is logged into the storefront account that owns the contract. Multi-account households sometimes log into the wrong one.
* For new Shopify customer accounts, confirm the **Subscription Management** block has been added to the Subscriptions template in the theme editor, see [Configuring the Subscription Management block (new customer accounts)](https://docs.roadmap.so/subscriptions/storefront-and-accounts/configuring-the-subscription-management-block-new-customer-accounts.md).
* For legacy customer accounts, confirm the subscription page template includes Roadmap's customer dashboard, see [Configuring the Customer Subscriptions widget (legacy customer accounts)](https://docs.roadmap.so/subscriptions/storefront-and-accounts/configuring-the-customer-subscriptions-widget-legacy-customer-accounts.md).

**A customer says the address picker won't accept their new country**

This is the country restriction. Customers can only use addresses in the country their subscription ships to now, so addresses in other countries don't appear in their picker. If they've genuinely moved to another country, change it from the Roadmap admin, **Shipping address** card → **Edit**, on their behalf.

**A customer says their address change didn't save**

The address didn't pass validation, so the contract kept the one it had. Open the contract's Timeline and find the `Shipping address update failed` event, which names the reason. The two that come up most are a postal code that doesn't agree with the city or region, and a missing or invalid phone number on stores that require a phone at checkout.

**A customer can't remove a product from their subscription**

There is only one subscription product on the contract, so the **Remove** link is hidden. A subscription has to keep at least one product. If they want to stop receiving it, they pause or cancel instead. If they want something different, they use **Swap product**.

**A product the customer wants to swap to isn't listed**

Products on an active subscription can only be swapped for other products set up on the same subscription plan. If the product isn't in that plan's **Subscription Products**, it is not offered.

Add the product to the plan the subscription is on, and it becomes swappable for every customer on that plan.

**A product the customer wants to add as a one-off isn't listed**

The one-off list comes from the plan's **One-off products** setting, which is configured separately from the plan's subscription products. A product can be subscribable and still be left out of the one-off list.

If the product is deliberately not published to your online store, **Include unlisted products** on that plan is what allows it through. See [How to set up a subscription plan](https://docs.roadmap.so/subscriptions/getting-started/how-to-set-up-a-subscription-plan.md).

**Two customers see different prices on the same one-off product**

That is the plan's one-off discount offers working as intended. Offers are scoped by membership tier or customer tag, and each customer receives the best offer they match, so prices legitimately differ between customers. See [Offer one-off products at a discount](https://docs.roadmap.so/subscriptions/getting-started/offer-one-off-products-at-a-discount.md).

#### Frequently asked questions

<details>

<summary>Do legacy and new customer accounts have different functionality on this dashboard?</summary>

No. The functionality is identical. The dropdown menu, the action behavior, and the status-dependent visibility are all the same. The only difference is how it's styled, which is configured in different places.

</details>

<details>

<summary>Can a customer add a one-off product to a single delivery?</summary>

Yes. Using **+ Add product to order** on the subscription card, they choose **Next order only** and pick a product. It ships once and does not join the contract.

What appears in the picker is controlled by the plan's **One-off products** setting. See [Adjusting an upcoming subscription order](https://docs.roadmap.so/subscriptions/managing-subscriptions/adjusting-an-upcoming-subscription-order.md).

If the plan runs one-off discount offers and the customer qualifies for one, those products are shown at the discounted price. See [Offer one-off products at a discount](https://docs.roadmap.so/subscriptions/getting-started/offer-one-off-products-at-a-discount.md).

</details>

<details>

<summary>What happens if a customer pauses on a Failed subscription?</summary>

They can't. The **Pause** action is hidden from the dropdown for Failed contracts. The available actions are **Edit Address**, **Update Payment**, **Reactivate**, and **Cancel**. If they want to step away without losing the contract, they update payment first and then reactivate, or cancel.

</details>

#### Related guides

* [Configuring the Customer Subscriptions widget (legacy customer accounts)](https://docs.roadmap.so/subscriptions/storefront-and-accounts/configuring-the-customer-subscriptions-widget-legacy-customer-accounts.md)
* [Configuring the Subscription Management block (new customer accounts)](https://docs.roadmap.so/subscriptions/storefront-and-accounts/configuring-the-subscription-management-block-new-customer-accounts.md)
* [Adjusting an upcoming subscription order](https://docs.roadmap.so/subscriptions/managing-subscriptions/adjusting-an-upcoming-subscription-order.md)
* [Offer one-off products at a discount](https://docs.roadmap.so/subscriptions/getting-started/offer-one-off-products-at-a-discount.md)
* [Updating a customer's payment method](https://docs.roadmap.so/subscriptions/managing-subscriptions/updating-a-customers-payment-method.md)
* [Pausing, canceling, and reactivating subscriptions](https://docs.roadmap.so/subscriptions/managing-subscriptions/pausing-canceling-and-reactivating-subscriptions.md)
* [Loyalty points × subscriptions](https://docs.roadmap.so/subscriptions/storefront-and-accounts/loyalty-points-subscriptions.md)
* [The Subscription Activity Timeline](https://docs.roadmap.so/subscriptions/managing-subscriptions/the-subscription-activity-timeline.md)
* [Changing a subscription's shipping address](https://docs.roadmap.so/subscriptions/managing-subscriptions/changing-a-subscriptions-shipping-address.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.roadmap.so/subscriptions/storefront-and-accounts/the-customer-subscription-dashboard-a-tour.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.
