The Customer Portal page is where you decide what your customers can do in their subscription portal, what it says and how it looks. Most of it is in the portal editor. The other tabs cover custom CSS, the Manage Subscription button, the login page, upsell products and custom HTML.
For the first-time setup, including where customers find the portal, see Set up your Customer Portal.
Open the Customer Portal page
In your Shopify admin, open Appstle Subscriptions and click Customer Portal. The page has six tabs.
The Customer Portal page, with its tabs and the Customize portal button.
Tab | What it is for |
Portal Editor | The portal's texts, features, look and settings in one place. The Customer portal card shows where customers manage subscriptions, the look and your languages. See Customize your portal below. |
Custom CSS | Your own styling for the portal on your online store. See Add custom CSS below. |
Manage Subscription Button | Ways to add a Manage Subscription button to your theme or customer accounts. See Add the Manage Subscription Button to customer accounts. |
Customer Portal Login | Your login page link, where customers ask for a secure link by email, whether that link opens the portal without a login, and the login page wording. See Enable Customers to Manage Subscriptions with Magic Link. |
Upsell Products | Choose and order the subscription products shown in the portal's You May Also Like section. For a video, see How to Upsell Products on Subscription customer portal? |
Custom HTML | A banner or buttons added to the portal. See Add a banner or buttons to your customer portal with Custom HTML. |
The Watch guide button at the top of the page plays a short video for the tab you are on. When you change something on a tab, click Save in the bar at the top of the page. The portal editor has its own Save button.
More actions
The More actions menu at the top of the page has two items.
Activity log opens the log of changes made to your customer portal settings.
Resend texts to your store sends all your saved texts to your store again, in every language. Use it when a text you saved doesn't show on your storefront. It covers the customer portal, subscription widget, Build-a-Box, bundles, campaigns and gifts, but not unsaved edits. Click Resend texts to confirm. You see Texts resent to your store when it works, or Texts couldn't be resent. Please try again. when it doesn't.
Customize your portal
On the Portal Editor tab, click Customize portal to open the portal editor. The preview in the middle shows a sample subscription with products from your store. The side panel on the left has four parts:
Pages: pick a page or popup, then click anything on the preview to edit it.
Features: choose what customers can do in their portal.
Look: colors and text size.
Settings: where customers manage subscriptions, how dates appear and when customers can make changes.
To find any feature, text, color or setting, type in the Search features, texts, colors and settings box at the top. For a portal on your online store, the desktop and mobile buttons beside it switch the preview between a computer and a phone.
Click Save in the editor to apply your changes. Customers see them the next time they open or refresh their portal. If you close the editor before you save, your changes are kept: click Save in the bar at the top of the page. To see the editor at work, watch Customize your customer portal with the Portal Editor.
Pages: edit the texts
Every word customers read in the portal is editable here. Click a text on the preview to change it, or pick a page or popup in Pages. Click a button or element to see its switch, text, colors and related settings together. A text that appears in several places changes everywhere. If your store has more than one language, choose the one to edit in the language menu at the top.
Showing switches the preview between subscription states, such as Active, Paused or Canceled. Special cases shows on the preview the texts that customers see only in less common situations. Click it again to hide them.
The More actions menu inside the editor has Replace a word, Export CSV and Import CSV, for changing many texts at once.
Keep variables, the words in double curly braces, as they are, so the subscription's own values still appear. The editor warns you when a text no longer shows one.
Other texts, at the end of the page list, holds the texts customers don't see right now, such as those of a feature that is off. You can change them before you turn the feature on.
In a language other than English, the number beside a page counts its texts that are empty or still in English.
When customers can't see the page or popup on the preview, a banner names the switch in Features that hides it.
Features: choose what customers can do
The first groups in the Features panel, with how many switches are on in each.
Each group lists switches, each with a short explanation. The count beside a group, such as "6 of 11 on", shows how many of its switches are on. Less common switches that are off are under More options at the end of their group. Use Filter features to find a switch by name. Some switches open more options when you turn them on. A feature that needs a higher plan shows a plan notice next to it.
Group | What it covers |
Retention | Cancel, pause and resume, Lock subscriptions until the minimum number of orders with its options for what customers can still do while locked, and picking a used discount reason again. These switches are also in Retention Management: cancel and pause are at the top of the Cancellation and Pause tabs, and the rest are in Advanced Configuration. A change on either page shows on both. What customers see after they click Cancel or Pause is set in Retention Management. |
Subscription actions | Order now, skip upcoming orders, and split or combine subscriptions. |
Schedule and frequency | Rescheduling the next and later orders, changing how often orders arrive, other reschedule days, and the estimated delivery date range. |
Products | Adding, removing and skipping products, changing quantities, out-of-stock products, product descriptions and links to the product page. |
Swap products | Swapping products, and changing a product's size or color. |
One-time products | Adding and removing one-time products. |
Build-a-Box and bundles | Adding products to bundles, changing quantities, going over bundle quantity limits, and swapping products in fixed-price bundles. |
Prepaid subscriptions | Changing products, adding one-time products and skipping deliveries on prepaid subscriptions. |
Shipping | Changing the shipping address and delivery method. |
Pickup & Delivery | For stores that use Appstle Pickup & Delivery: hiding the Pickup, Delivery or Shipping option. If you hide all three, customers see all three. |
Discounts | Applying discount codes, adding a discount when one is already applied, what happens to a product's discount when it is removed, subscription discounts on one-time products, and extra discounts on added products. |
Product attributes | Showing custom order and product details. |
Order notes | Adding and editing order notes. |
Page layout | What the portal shows: the subscription list when there is only one subscription, rewards, order history, upcoming orders, reward progress, the next-order card, the shipping card, discount details under products, order notes, fulfillments and additional order details. It also covers editing the payment method, opening the account page in the same tab, showing prices in the customer's currency and the "Powered by Appstle" line. |
Look: colors and text size
Colors, text size and the reward progress bar transparency are in Look. With Shopify's style, the portal uses default colors. Inside Shopify customer accounts, Shopify sets the colors, and the Text and display options don't apply. To choose your own colors, open Settings, go to Portal, choose On your online store, then choose Your store theme as the Look. For a walkthrough, see Match Your Customer Portal to Your Store's Brand Colors.
Settings: limits, dates and rules
Settings is a list of groups. Some appear only when the matching feature is on in Features. A setting that needs a higher plan is locked and shows a plan notice.
Group | What you set |
Portal | Where customers manage subscriptions: On your online store, with a Look of Your store theme or Shopify's style, or Inside Shopify customer accounts. Choose an option, click Use this option, then click Save. The Manage Subscription button follows the change, but links you added yourself, such as one in your customer account menu, don't, so update those too. If your store uses classic customer accounts, only On your online store is available. Managing subscriptions inside Shopify customer accounts needs Shopify's new customer accounts. |
Skipping | A limit on how many orders customers can skip, counted in a row or overall. Shown when customers can skip upcoming orders. |
Dates | The calendar language and date format, the days of the week customers can pick, where date selection starts (today or the last billing date), how many days ahead customers can schedule, and a processing buffer in days. |
Estimated delivery | Days to add to the order date for the earliest and latest delivery estimate. Shown when the estimated delivery date range is on. |
Frequency changes | Whether customers pick from your subscription plan frequencies or enter a custom billing interval, and which plan frequencies they see. Shown when customers can change how often orders arrive. |
Timing limits | When, before the next order, customers can still make changes. Canceling, pausing or skipping also covers rescheduling, changing frequency and ordering now. Product changes also covers custom product details, skipping products and Build-a-Box changes. Each has a From and an Until value, in days before the next order. Leave a value empty for no limit. |
Products | How many products to show per page, whether customers can remove products from bundles, the minimum quantity when adding or changing products, the minimum number of products in a subscription and the minimum order value. |
More rules | A collapsed list of less common groups: Product restrictions (which products customers can add, swap to or buy once, by product, variant and tag), Product picker filters, Discounts on added products, Delivery areas (ZIP or postal codes) and My account button (a custom destination for the My Account link). Click More rules to open the list. A group you have already set always shows. |
Add custom CSS
On the Custom CSS tab, paste your own CSS to restyle the portal on your online store, then click Save in the bar at the top of the page. If part of your CSS can't be applied, a warning says how many rules won't be applied on the storefront. Click View details to see each rule and the reason.
Properties that aren't supported are skipped, and so are values that use
url()orattr().Negative or calculated margins that could shift content off the screen are skipped.
If a selector can't be applied safely, the whole rule is skipped. Rules that start with
@are removed, except@mediaand@font-face.A font in
@font-facemust load from a directhttps://URL.CSS larger than 64KB isn't applied at all.
Custom CSS doesn't change the portal inside Shopify customer accounts, where Shopify limits customization. After you change the styling, open a test subscription on your storefront to check it.
Things to know
A feature can be on and still not show for a customer. Some buttons show only in certain states, such as Resume on a paused subscription: choose that state in Showing to preview it. Also check the portal option under Settings → Portal, the Timing limits in Settings, and any note under the switch, such as Also hidden by an older layout option. Click Show it to clear that one.
Some switches work only with certain portal options, and the editor hides the ones that don't apply to yours. For example, inside Shopify customer accounts, switches that work only on your online store are hidden. When a switch works with some options only, its explanation says which.
Old links to the Configuration, Labels and Customization tabs open the Portal Editor tab.
FAQs
Where did the Configuration, Labels and Customization tabs go?
They moved into the portal editor. On the Portal Editor tab, click Customize portal:
The texts from the Labels tab are in Pages.
The switches from the Configuration tab are in Features. Its limits, dates and product rules, and where customers manage subscriptions, are in Settings.
The show and hide switches from the Customization tab are in Features, most of them under Page layout. Its colors and text size are in Look.
To find a setting, type what it does in the search box at the top of the editor.
How do I edit the portal's texts in another language?
In the portal editor, choose the language in the menu at the top, then edit the texts. The menu lists the languages you have added in Shopify under Settings → Languages. It doesn't show when your store has only one language, or when multi-language texts aren't turned on for your store. Without multi-language texts, you edit one set of texts that every customer sees. To turn them on, contact Appstle support.
Why can't I choose my own colors?
With Shopify's style, and inside Shopify customer accounts, the colors are set for you. To choose your own, open Settings → Portal and choose On your online store with the Your store theme look. Then change the colors in Look and click Save.
I saved a text, but customers still see the old one.
Ask the customer to refresh their portal. If it still shows the old text, open More actions → Resend texts to your store. Also check that you edited the language the customer uses.
Why can't I save my changes?
The editor stops the save when a text or a setting has a problem. It opens the first one for you and shows a message such as Fix 1 text before saving. Fix it, then click Save again. A text can't hold script tags or HTML comments, and every variable needs its double curly braces on both sides.
Does custom CSS work in the portal inside Shopify customer accounts?
No. Custom CSS styles the portal on your online store. Inside Shopify customer accounts, Shopify limits customization, so your CSS isn't applied there.


