> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/features/customer-portal.md).

# Customer Portal

Give customers a page on your store where they can view and manage their subscriptions, and choose which actions they can take there.

The **customer portal** is a page on your store where customers view and manage their own subscriptions. They can check their next order, change products and frequency, update their address and payment method, skip or reschedule an order, and pause or cancel, depending on what you allow.

Letting customers handle these changes themselves saves you support time and gives customers more control.

The portal address of your store is:

```
https://YOUR-STORE-DOMAIN/apps/subscription
```

## Set up the portal

{% stepper %}
{% step %}

### Open Customer Portal

In the app menu, click **Customer Portal**. The page has two cards: **Customer portal login page** and **Subscription actions**.
{% endstep %}

{% step %}

### Choose what customers can do

In **Subscription actions**, turn each action on or off, then click **Save** in the save bar. See [What each action controls](#what-each-action-controls).

![The Subscription actions card with its seven switches](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FBkag4ftW2zemV6q2XVoT%2Fcustomer-portal-actions.png?alt=media)
{% endstep %}

{% step %}

### Show customers where to find the portal

In **Customer portal login page**, you can:

* click **Copy** to copy the **Customer portal URL**,
* click **Preview page** to open the portal in a new tab,
* click **Add to store menu** to open **Menus** in Shopify admin, where you add the portal URL to your store menu. The app does not add the link for you.

![The Customer portal login page card with Copy, Preview page and Add to store menu highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FbSpYTH8A2dL41SNw2l5e%2Fcustomer-portal-url.png?alt=media)

See [How customers open the portal](#how-customers-open-the-portal) for other ways to share the link.
{% endstep %}
{% endstepper %}

## What each action controls

| Switch                      | What customers can do when it is on                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Cancel subscription**     | Cancel their subscription with **Cancel Subscription**. When it is off, customers have to contact you to cancel.                                 |
| **Pause and resume**        | Pause an active subscription with **Pause Subscription**, and resume a paused or cancelled one.                                                  |
| **Pay now**                 | Pay for the next order right away with **Order Now**, **Place Order** in **Upcoming Order**, and **Recharge** a failed order in **Past Orders**. |
| **Skip next payment**       | Skip an upcoming order, and resume a skipped one, in **Upcoming Order**.                                                                         |
| **Edit upcoming order**     | Change product quantities, remove products, and add products with **Add Product**.                                                               |
| **Change frequency**        | Change the delivery frequency of their subscription.                                                                                             |
| **Reschedule billing date** | Move an upcoming order to another date.                                                                                                          |

When an action is off, its button is hidden or greyed out in the portal.

Customers can always do these, with no switch to turn them off:

* edit their **Shipping Address**,
* change their **Payment method**: choose another saved card or click **Send link to update Card** to get an email from Shopify. Customers can't type a new card in the portal,
* apply a discount code in **Discounts**, or remove a discount from the subscription.

{% hint style="warning" %}
Customers can remove **any** discount on their subscription in the portal, including a discount you added yourself.
{% endhint %}

### Limits

* **Minimum billing cycles.** If the plan option has **Minimum billing cycles**, customers can't cancel until they reach it: the **Cancel Subscription** button is hidden. **Pause Subscription** is shown, but the portal refuses the pause with a message. See [Create a selling plan](https://subscriptions-docs.tech-arms.io/features/subscription/how-to-create-a-subscription-plan.md).
* **Reschedule** moves an order only within its own billing period. It is not available for prepaid plans or plans billed every few days.
* **Change frequency** lists the plan options of the same selling plan, and **Custom frequency**.
* **Add Product** charges the product at its regular price. Subscription discounts are not applied to added products.
* A subscription must keep at least one product. Setting a quantity to 0 removes the product.
* Products can't be edited on a cancelled subscription.

## What customers see

{% stepper %}
{% step %}

### Log in

Customers click **Please login to access your account** and sign in with their store customer account. Shopify emails them a one-time code, so no password is needed.

Being logged in to your online store is not enough: customers click the portal's login button once more. The portal session lasts 24 hours.

![The customer portal login page](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FFd4jYdlMAdaafrhRvpPX%2Fcustomer-portal-login.png?alt=media)
{% endstep %}

{% step %}

### See all subscriptions

The portal lists every subscription of the customer with its status and next billing date. Customers can search by contract ID, filter the list, and switch between **List** and **Grid** view. Click **View Details** to open a subscription.

<figure><img src="https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2Fgit-blob-585755b1695e4e67dcc3fa3a008546a99661854b%2Fimage%20(163).png?alt=media" alt="The list of subscriptions in the customer portal"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Manage a subscription

The **General** tab shows the next order with its products and total, and cards for **Order Frequency**, **Shipping Address**, **Payment method**, and **Discounts**. **Order Now**, **Pause Subscription**, and **Cancel Subscription** are on this tab.

<figure><img src="https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2Fgit-blob-0ae3478d38762fad41571bb18c76ea05299bf261%2Fimage%20(164).png?alt=media" alt="The General tab of a subscription in the customer portal"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Manage upcoming orders

The **Upcoming Order** tab lists the next orders. From the menu of each order, customers can skip it, reschedule it, or place it now, depending on the actions you allow.

<figure><img src="https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2Fgit-blob-fc58fb74c2d936f636475c572eec11bd6e5a3069%2Fimage%20(168).png?alt=media" alt="The Upcoming Order tab in the customer portal"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Check past orders

The **Past Orders** tab shows earlier billing attempts with their billing and fulfillment status. If a payment failed, customers can use **Recharge** to pay for that order. It can take up to 5 minutes.

<figure><img src="https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2Fgit-blob-ec651c345e3f23c467284c6c5227de9e89a4bd68%2Fimage%20(169).png?alt=media" alt="The Past Orders tab in the customer portal"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## How customers open the portal

* **Your store menu.** Add the portal URL with **Add to store menu**.
* **A button on your store.** In the theme editor, add the **Portal link** app block, for example on the cart page. You can change its text in **Button Content** (default: **My Subscriptions**). The app embed of the app must be turned on.
* **Emails.** The emails sent by the app include a **View Subscription Details** button. See [Email Notifications](https://subscriptions-docs.tech-arms.io/features/email-notifications/email-notifications.md).
* **A direct link** to `/apps/subscription/contracts`.

The order confirmation page after checkout has no portal link.

## Subscription Management in customer accounts

Shopify customer accounts can also show a **Subscription Management** section, added by the app. You turn it on from the app's setup guide with the step **Let customers manage their subscriptions easily!**.

This section is separate from the portal and works differently:

* The **Subscription actions** switches and **Minimum billing cycles** do not apply there. Customers can always cancel, pause, and skip.
* It can resume paused subscriptions, skip orders, edit the address, and change the card.
* It can't change frequency, edit products, apply discount codes, pay now, or reschedule.

{% hint style="warning" %}
If you need to stop customers from cancelling, or require a minimum number of orders, don't turn on **Subscription Management** in customer accounts. Send customers to the portal instead.
{% endhint %}

## Good to know

* **Language.** The portal follows the language customers choose on your store. To change its text or translate it, see [Multilingual pages](https://subscriptions-docs.tech-arms.io/features/translation/translation.md). The login page text is always in English.
* **Changes you make in the app** can take up to 2 minutes to show in the portal.
* **Cancellation reasons and retention offers** are not available.
* **Custom design.** To change the look of the portal with custom CSS, contact us.

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# 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://subscriptions-docs.tech-arms.io/features/customer-portal.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.
