Bought a subscription from a store? The store you bought from runs it, and the store is the one to contact about an order, a charge or a refund.
Trouble logging in? Open the latest email the store sent you about your subscription and press Manage subscription: from an email sent in the last 3 days, it opens your subscription already signed in. Or log in at portal.subi.co/login with the email you used at checkout. Your code comes by email from the store, so check your spam folder, or press Click to resend on the code screen. Still stuck? Ask the store to send you a sign-in link; they can send one from your subscription page.
Nav update: the Storefront primary-nav item has been renamed to Storefront & Portal. The hub now contains two cards (Subscription widget, Customer portal) for easier discovery. Old Storefront sub-paths still work.
Subscribers can manage their subscriptions through two dedicated customer portals provided by Subi:
Subi Hosted Portal – A secure, ready-to-use portal hosted at portal.subi.co, requiring no code changes.
Customer Account Extension (Embedded Portal) – A fully branded, white-label portal embedded in Shopify’s New Customer Accounts, seamlessly aligned with your store’s design.
Both portals offer the same powerful self-service tools to view, update, and control active subscriptions.
What can subscribers do in the portals?
In both the Hosted Portal and the Embedded Portal, subscribers have full control over their subscriptions. They can:
View subscription details – Products, prices, next order dates, the first order date and when the card on file expires
Cancel a subscription – End a subscription, within the limits you set, such as a minimum number of days before an order
Pause or resume – Temporarily stop a subscription, either until a date they choose or until they restart it themselves
Skip or reschedule an order – Adjust the next delivery date. A paused subscription can skip its next order too, and when you set a skip limit, the subscriber sees how many skips they have used
Change the delivery interval – Update how often orders repeat
Adjust product quantity – Increase or decrease item counts, within the minimum and maximum you allow
Add or remove products – Customize items in a subscription
Add a product to the next order only – One item ships with the next order and the subscription stays the same (see below)
Stock up – Add one more of a product to this delivery or to every delivery, where you offer it
Swap products – Replace one product with another
Apply Shopify discount codes – Redeem valid discounts and see the code applied to the subscription
Remove a loyalty reward – If you run a Subi loyalty program, a reward the subscriber applied to the subscription is shown on it with a Remove button. The points used for it are not refunded
Follow their streak – Where you run a streak campaign, the subscription shows the subscriber's streak and the rewards ahead
Fix a failed payment – Update the card, retry the payment or pay with another saved card (see below)
Combine two subscriptions – Put two subscriptions on the same schedule into one delivery, when you allow it
Update payment details – Change payment method on file
Edit shipping address – Update delivery location. Not offered on a local pickup subscription
View order history – See all past subscription orders
Add notes to contract or orders – Include instructions on recurring orders
Can subscribers add a product to their next order only?
Yes, in both the Hosted Portal and the Embedded Portal. When a subscriber adds a product to their subscription, they can choose to add it to their next order only instead of to every order.
When the subscriber edits their subscription, every product they have just picked shows a Purchase option with two choices:
Add to subscription – the default. The product joins the subscription and ships with every order, as before.
Add to next order only – one item ships with the next order, and the subscription itself stays the same. The window says so under the product: "Ships with your next order only. Your subscription stays the same."
The subscriber sees the price they will pay before they save. If one of your upsell rules offers that product as a one-time purchase, the rule's one-time discount applies; otherwise it is the product's full price. The quantity is always one.
Once saved, the product is listed for the next order on the subscription page, and the next order's total includes it. It is not added again to later orders.
The choice is not shown on a paused subscription, on products already in the subscription, or when your customer permissions do not let customers add products. In those cases a picked product joins the subscription as before.
How long does a pause last?
When a subscriber pauses a subscription in either portal, Subi asks how long they want to pause it. They can choose to Skip the next order only, to Pause for 2 orders, to Pause for 3 orders, or to Pause with no end date.
If they choose 2 or 3 orders, Subi shows the date the subscription starts again before they confirm, and that date is then shown on the subscription. The subscription starts again on its own on that date, and the subscriber does not have to come back and resume it.
Skip the next order only is not a pause at all: the subscription stays active and only its next order moves forward by one interval. It follows the same rules as skipping, so it is not offered when skipping is switched off for your store, and it is refused when the subscriber has reached their skip limit or the next order is too close.
Pause with no end date works the way pausing always has: the subscription stays paused until someone resumes it. The subscriber has to tick a confirmation before Subi accepts it.
The reminder email, three days before
Three days before a paused subscription starts again, the subscriber gets an email that names the date. The email carries two links that need no login. Opening either link only shows a page with one button, so nothing changes until the subscriber presses it.
The first link keeps the subscription paused for another month when the subscriber presses Keep it paused. It works once.
The second link does not cancel by itself. Its button, Continue to cancellation, signs the subscriber into the portal and opens the cancellation flow for that subscription: the reasons, any offers you set up, and the cancel button at the end. If your store has no cancellation flow turned on, the portal's usual cancel dialog opens instead. Nothing is cancelled unless the subscriber finishes; if they leave, the subscription stays paused and starts again on its date. This link keeps working until the pause ends.
While a subscription is paused, the cancellation flow does not offer Skip next order or Delay next order, because starting again on its date would undo them. Your other offers, such as a frequency change or a discount, are still offered. This applies however the subscriber opens the flow.
The cancel link is left out for stores that do not let customers cancel from the portal. The email itself is the Paused subscription starts again soon notification, which you can switch off or edit under Settings → Notifications → Email.
What happens when a subscriber resumes a paused subscription?
Both portals show Resume on a paused subscription, even when your customer permissions do not let customers pause. When the subscriber resumes, Subi can ask When should your next order go out? Send my order today charges and places the order today. Wait for my next scheduled order keeps the next order on its scheduled date, which is shown before they confirm.
If a subscription was paused because its payment failed, and the subscriber then updates their card, the subscription page offers to resume it.
What can subscribers do after a failed payment?
When a subscription payment fails, both portals show a failed-payment banner on that subscription. It names the order that could not be charged and, when known, the reason.
While Smart payment recovery is working on the payment, the banner offers the actions that can fix it:
Update card – Replace the card on the subscription. In the Embedded Portal this finishes on Shopify's secure page.
Retry payment – Charge the failed order again on the card already on the subscription, for example after the subscriber has added funds.
Pay now – Pay the failed order with another saved card, Shop Pay or PayPal. If it goes through, that method pays the next orders too. It appears only when your customer permissions let customers change their payment method.
Contact your store – Shown when a new card will not fix the problem, for example when an item could not be fulfilled.
Which buttons appear depends on why the payment failed, how close the next order is and your store's settings, so a subscriber may see only some of them. When none applies, the banner still tells the subscriber that the last payment failed.
Combining subscriptions and streaks
When you let customers combine subscriptions, a subscriber with two subscriptions on the same schedule sees an Optimize your delivery card above their list of subscriptions, in both portals. 📖 Can my customers combine two subscriptions into one?
When you run a streak campaign, a subscription with a streak shows a streak card with the subscriber's progress and a View Rewards button, in both portals. A subscription without a streak shows nothing new. 📖 How do subscription streaks and rewards work?
How do subscribers access their portal?
Customers can access their subscription portal in a few ways:
Direct link: https://portal.subi.co/login/
Subi confirmation email (if enabled in Subi settings)
Shopify customer account (Legacy or New Accounts, depending on your setup)
Hosted vs. Embedded Portals
Both the Subi Hosted Portal and the Customer Account Extension (Embedded Portal) give subscribers the same management features. The main difference is how they’re accessed and how they appear to customers.
Feature | Subi Hosted Portal | Customer Account Extension (Embedded Portal) |
Location | Hosted on a Subi URL (portal.subi.co) | Lives inside Shopify’s customer account area |
Branding | Subi-branded, with store logo and favicon | Fully white-labeled and inherits your store’s theme styling |
Setup Effort | No code changes required, works instantly | Requires enabling Shopify New Accounts and adding Subi extension |
Login Method | Passwordless email login (Subi-managed) | Shopify-managed login (secure and seamless) |
Customer Experience | Customers leave your storefront to manage subscriptions | Customers stay on your store’s domain, fully integrated |
Recommended Use | Best for quick setup and no theme adjustments | ✅ Recommended: Provides the most seamless, branded, and professional experience |
We recommend the Customer Account Extension (Embedded Portal) for most merchants. It keeps subscription management inside your store, aligns with your branding, and ensures a smooth customer experience.
How does Subi choose which portal link to send in emails?
The portal link included in your subscription-related emails depends on your selected portal destination in Subi.
Here’s how it works:
If you’ve chosen the Subi Hosted Portal:
Customers will be directed to the hosted login page at
https://portal.subi.co/loginIf you’ve enabled the Customer Account Extension:
Customers will be taken to the subscription section within their Shopify customer account instead.
How to update your portal link destination
To change or confirm your portal link:
Go to Storefront & Portal > Customer Portal in your Subi admin.
Click Configure portal.
Choose your preferred Portal link destination — either Subi hosted portal or Customer account extension.
Tip
Your selected portal destination automatically updates all links included in Subi’s customer-facing emails, ensuring a consistent experience for your subscribers.
Customizing and translating the portals
Both the Subi Hosted Portal and the Customer Account Extension (Embedded Portal) can be customized and translated from a single setting in Subi.
This means you can:
Add your own branding (logo, favicon, colors)
Customize text labels and instructions to match your store’s tone
Translate the portal into multiple languages for international customers
📖 Learn more in our detailed guide: Subi Customer Portal Customization and Translation Features
Controlling what customers can do in the portals?
As a merchant, you can decide which actions your subscribers are allowed to take in their portal. This lets you control the customer experience and align subscription management with your business rules.
For example, you can choose whether customers can:
Cancel or pause a subscription
Swap, add, or remove products
Apply discount codes to existing subscriptions
📖 See the full guide here: Manage Customer Permissions
Controlling cancellations with the Cancellation flow (Smart Cancel Flows)?
Subi provides a Cancellation flow (formerly “Smart Cancel Flows”) that lets you shape what happens when a customer tries to cancel a subscription in either portal. In the new IA the configuration page is reachable from the Retention hub via the Cancellation flow tile.
With the Cancellation flow, you can:
Add a cancelation survey to learn why customers cancel
Suggest alternatives like pausing or skipping instead
Offer discount incentives to retain subscribers
Offer a product swap, so the subscriber switches a product instead of cancelling. Subscribers see it in both portals when your flow includes it
📖 Learn more in our full guide: Canceling Management Tools (Smart Cancel Flows)
Next Steps
Review Subi Customer Portal Customization and Translation Features to brand and translate your portal
Configure Customer Permissions to control what subscribers can do in their portal
Set up the Cancellation flow (Smart Cancel Flows) to reduce churn and improve retention
If you need help with setup or linking the portal, contact our support team from the in-app chat box

