Skip to main content

How can I customize and translate the Subi Customer Portals?

Learn how to customize branding, permissions, translations, Smart Cancel Flows, and styling for both Subi portals.

Subi gives you full control to customize the Hosted Portal and the Customer Account Extension (Embedded Portal). Both portals share the same customization settings in Subi, so you only need to configure them once.

These settings allow you to deliver a branded, localized, and user-friendly subscription experience that reduces confusion and strengthens customer trust.


Where to customize the portals

All customization settings for both portals can be found in your Subi Admin:

  1. In Subi, go to Storefront & Portal → Portal

  2. In the first card, Where customers manage subscriptions, click Customize portal. You can also click the small preview of either portal in that card.

  3. Use the editor to change the texts and styling of each portal page

Changes you make here automatically apply to both the Hosted Portal and the Embedded Portal.

Portal customization editor showing the Home page with the Texts tab open

How the editor is laid out

  • Page switcher – the bar at the top shows which portal page you are editing. Click it and choose Home page (the list of subscriptions) or Subscription page (one subscription in detail).

  • Texts tab – the “A” icon on the left of the sidebar. It holds every text on the page, grouped in sections. The Header section opens first; click any other section to expand it.

  • Design tab – the brush icon above it. It holds Custom CSS.

  • Live preview – the right side shows the page as your customers see it and updates as you type. Clicking a field shows the matching part of the page, for example a status badge or the discount message.

  • Open portal login – the button at the top right opens your portal’s login page in a new tab, so you can check it as a customer would.


Customizable content and translations

You can edit all the text displayed in the customer portals to match your brand voice, and translate it into your customers' languages.

This includes:

  • Labels and buttons – Rename default actions (e.g., “Skip Order” → “Delay Delivery”)

  • Instructions and messages – Adjust tone to match your brand’s style (friendly, formal, concise, etc.)

  • Headings and descriptions – Customize portal titles like “Manage Subscription” → “Your Plan Settings”

👉 Updates apply across both portals from a single place, ensuring consistency.

Where do I translate the customer portal?

You edit the portal's English text in the portal editor (Customize portal), and you translate it in Settings → Languages in your Subi admin. There, click Translate next to a language and choose Customer portal. The last row of the editor's Texts tab, Languages, takes you to the same page.

You can also start from the Portal page: in the Portal settings card, the Portal languages row lists each published language of your store. Click Edit next to a language to open its customer portal translations, or Open Languages to see every language.

Settings → Languages also holds your subscription widget and selling plan translations, so every language is managed in one place. For step-by-step instructions, see Translate your customer portal into your store's languages.

Page switcher menu with Home page and Subscription page

Custom CSS (Hosted Portal only)

To add custom CSS, open the Design tab (the brush icon in the sidebar) and enter your CSS in the Custom CSS section.

Design tab with the Custom CSS field

For advanced branding, you can apply custom CSS to the Subi Hosted Portal. This feature allows you to:

  • Match fonts, colors, and layouts with your storefront

  • Create a unique look that aligns with your brand identity

  • Go beyond the default design for a fully tailored experience

⚠️ Note: Custom CSS is only available for the Hosted Portal. The Embedded Portal automatically inherits your store’s Shopify theme styling and does not support custom CSS.


Customer portal permissions

Merchants can control what customers are allowed to do inside their portal. For example, you can decide whether subscribers can:

  • Cancel or pause a subscription

  • Swap, add, or remove products

  • Apply discount codes

📖 For setup instructions, see: Manage Customer Permissions


Smart Cancel Flows

Subi’s Smart Cancel Flows give you powerful tools to manage cancellations and reduce churn. You can:

  • Show predefined cancelation reasons to collect churn feedback

  • Offer alternatives like pause or skip instead of canceling

  • Provide discounts or special offers before final cancelation

📖 Learn how to configure these tools: Canceling Management Tools (Smart Cancel Flows)


Next Steps

  • Open Storefront & Portal → Portal → Customize portal to access all settings

  • Edit text labels to match your brand, and translate them in Settings → Languages

  • Add custom CSS for advanced branding

  • Adjust customer permissions to control what actions subscribers can take

  • Set up Smart Cancel Flows to reduce churn and improve retention

👉 With these tools, you can ensure that both the Hosted Portal and the Embedded Portal deliver a subscription management experience that feels seamless, branded, and customer-friendly.

Did this answer your question?