Skip to main content

Set up your Customer Portal

Choose between the Shopify Extension and Classic Customer Portal, add the required blocks, and let subscribers manage their own subscriptions.

Your Customer Portal is where subscribers manage their own subscriptions — skip, pause, swap products, reschedule, update payment, and more — without contacting you.

Appstle offers two portal types. Pick the one that matches your store's customer accounts. You can change this any time from Appstle admin → Customer Portal settings → Portal Type, or from the Setup readiness card on your dashboard.


Which portal should I choose?

Shopify Extension Customer Portal (recommended)

Classic Customer Portal

Best for

Stores on Shopify's new customer accounts

Stores that want a standalone, branded portal at a fixed URL

Where it lives

Inside the customer's Shopify account — native look & feel

A standalone page at your app-proxy URL

Setup

Add the Customer Portal blocks in the theme editor (below)

Available automatically — no blocks needed


Option A — Shopify Extension Customer Portal

Step 1 — Open your customer-account theme editor

From Shopify admin: Online store → Themes → Customer accounts → Customize. (Or click Open theme editor on the Setup readiness card / Customer Portal step.)

Step 2 — Add all the Customer Portal blocks

In the theme editor's Apps panel you'll find an Appstle Subscription → Customer Portal group. They all appear together. Add every block below — they work together, and missing any one leaves part of the portal non-functional:

Block

What it does

Manage Subscription Button

Adds a "Manage subscription" link on the Account, Orders, and Order Status pages so customers can reach the portal.

Subscription management

The entry page — lists all of a customer's subscriptions.

Subscription Detail

The detail view for a single subscription (items, schedule, address, payment).

Edit Subscription

Add / remove / swap products on a subscription.

Upcoming and Past Order details

Preview the next scheduled order(s) and past order history.

Subscription Product Update

Product update flows (variant changes, etc.).

Subscription Bundle

Build-a-Box / bundle support inside the portal.

Subscription Quick Action

Inline actions (skip, pause, reschedule) from the list.

Step 3 — The "Add to menu" prompt

When you add a block, Shopify asks whether to add it to the customer-account menu:

  • Subscription management → Yes. This is the entry point subscribers click into.

  • All other portal blocks → No. They're reached via deep-links from inside the list — adding them just clutters the account menu.

The Manage Subscription Button isn't a menu item — it's placed as a button on your Account / Orders pages.

Step 4 — Remove the old block (if present)

If your page still has the legacy single "Subscription management" block from before June 2026, remove it. (Migrating from that older setup? See the migration guide.)

Step 5 — Save

Click Save in the theme editor. The portal is live for your subscribers as soon as you save.


Option B — Classic Customer Portal

The Classic Customer Portal is automatically available at your app-proxy URL — no blocks needed, and no Manage Subscription link to add:

https://your-store.myshopify.com/apps/subscriptions

Add a link where customers can find it (account page, footer, subscription emails). Customize it under Appstle admin → Customer Portal settings.


Verify it's working

  • Open a test customer account on your storefront.

  • Confirm the subscription list loads, and you can open a subscription's detail, edit it, and view upcoming orders.

Need help?

  • 💬 Live chat in the Appstle Subscriptions admin app

  • 📧 Email support@appstle.com — available 24×7×365

Did this answer your question?