Enabling / Disabling the Billing Portal

The Billing Portal must be enabled before your subscribers can begin to interact with it. Here’s how to enable the billing portal for your site:

Enable the Billing Portal in settings

Subscriber Invitations

With automatic email invitations enabled, we will send an email invitation to your new subscribers. This email will contain a link that will give the subscriber automatic access to manage the subscription. Otherwise, you will need to invite your subscribers from the Subscriptions tab of Advanced Billing.

Decide to send manual or automatic Billing Portal invitations


  • Allow Plan Changes: Allow or disallow a subscriber to change their plans. You can choose the way the products available for the customer to choose from will be sorted in the view.
  • Allow Immediate Cancellations: Allow or disallow a subscriber to cancel their subscriptions immediately.
  • Allow Delayed Cancellations (at end of period): Allow or disallow a subscriber to cancel their subscriptions.
  • Allow Card Updates: Allow or disallow a subscriber to update their credit cards
  • Allow Profile Updates: Allow or disallow your a subscriber to update their customer profile information, such as name and email address.
  • Allow Component Changes: Allow or disallow a subscriber to change their components, quantity and on/off.
  • Remove Maxio Logo: Enabling this checkbox removes the Maxio logo from the billing portal for white-labelling purposes.
  • Allow Password Logins: If password logins are turned off, a customer can use the login screen to easily request a Login Link using their email address on file.
  • Display Churn Reason Codes: Enabling this will display churn reason codes to the subscriber upon cancellation if they’ve been defined.
  • Allow Putting Subscriptions On Hold: If enabled, this will allow customers to put their subscriptions on hold, either indefinitely, or, if ‘Allow Resuming Subscriptions’ is also enabled, it will allow them to specify a date and time to automatically resume.
  • Allow Resuming Subscriptions: If enabled, this will allow customers to manually resume their subscriptions, or to select a date to automatically resume when putting their subscription on hold.
  • Allow Applying Coupons: If enabled, this will allow customers to add coupons to their subscriptions.
  • Display Referral Codes: If enabled, this will allow customers to see their subscription’s referral codes.
Customize the Billing Portal by selecting the features that meet your business needs.

Sort Products for Plan Changes

We offer the ability to sort how products appear within the Billing Portal when a subscriber goes to change their product. This can help make it easier for a customer to find the product they are looking for; it can also let you prioritize newer or more expensive plans over older/cheaper plans.

Sort products by creation date, alphabetically, or by price.

Product Change Strategy

This determines how product changes by your customers are handled. Choose from 3 options:

  • Instantly with proration
  • Instantly without proration
  • Delayed till their next renewal date


Different strategies can be setup for different subscription states as well. Below the default option, which will apply to any subscription not specified, seperate strategies can be selected for both Trailing and Active subscriptions. Select either Active or Trialing and then select "Add Item". 


Then the product change strategy can be applied to that subscription state. The other subscription state can be added with their own as well. by following the same steps.


Please keep in mind how these component types work within Product Change Stratagies.

Usage-Based Components: Such as Metered or Event-Based Billing will be charged when the product change is set to occur. Once the subscription is on the new product the usage counts will reset to zero.

Quantity-Based Components: Such as Quantity-based, Prepaid Usage, and On/Off can be prorated down to the second if "Instantly with Proration" is selected. If "Instantly without proration" is selected the full amount of the components will be charged immediately.

For more information, please see our article on upgrades and downgrades.

When a customer visits their unique Billing Portal link, they will be presented with a screen to enter their email. They will then get an email sent to them with a unique URL to allow them to access their Billing Portal.

When a customer visits their management URL, they are automatically logged into the Billing Portal–no additional verification is performed.

Decide how you want to verify your subscribers.

Merchant Name

Enter the name you wish to display on the billing portal. This is useful to use if you do not have a logo.

Enter your company information that you would like to appear in the portal.

Merchant Info

This text shows on the main page of the Billing Portal. It should contain your contact information and anything else you want to tell your billing portal users. This field supports the markdown syntax and URLs and email addresses are automatically converted to clickable links.

Invitation Email Content

This invitation email will also be sent to all subscribers that you invite manually.


If automatic email invitations enabled, we will send this invitation email to your new subscribers. Like other emails, the invitation email is fully customizable. Simply click “Edit Template”. Please see the list of possible Liquid variables for emails.

Customize your Billing Portal invitations

Tip: Some merchants choose to include the Billing Portal invitation in the subscription signup email from Advanced Billing. This option will reduce the number of emails sent to the customer upon signup. Use the variable `subscription.billing_portal_management_url`


This logo will be shown at the top of your billing portal instance. If a logo is not uploaded, your business name will be shown instead.

View your current logo or select "browse" to upload your logo
Was this article helpful?
0 out of 0 found this helpful