Recharge Theme Engine

The Recharge Theme Engine allows you to customize the interface of your store's customer portal. The customer portal is a series of pages and controls that allow your customers to view or modify their subscriptions, change their billing information, or review their order history. With Theme Engine Theme Editor, you can customize the customer portal to fit your store's style and branding.

Eligibility

• Theme Engine is only available to Recharge Pro Plan or Enterprise merchants. If you are interested in enabling the Theme Engine, contact the Recharge support team. 
• We recommend having experience with JavaScript, AJAX, and HTML to use the Theme Editor. 
• Your store should have at least one customer with one active subscription to use Theme Engine.

Recharge Checkout on BigCommerce

• The default hosted URL for your customer portal is admin.rechargeapps. Refer to Setting up a custom customer portal domain to change this URL. 

Shopify Checkout Integration

• The Theme Engine is available to Pro Plan or Enterprise merchants using Shopify Checkout Integration and Migrated Shopify Checkout Integration with Theme Engine 4.0. If you are interested in enabling the Theme Engine, contact the Recharge support team.

Theme Engine Reference

Once Theme Engine is enabled for your store, you can use Recharge's Theme Engine Reference to customize your customer portal. 

Access the Recharge Theme Engine

Use the Theme Editor to customize your customer portal theme. To access the Theme Editor, click Storefront in your merchant portal, then select Theme Editor.

Create a new theme or edit an existing one

If you are using single payment methods and choose the Novum template, you will be asked if you want to develop a single payment method or multiple payment method theme.

You can upgrade to multiple payment methods by publishing the new multiple payment method theme. Once you publish a multiple payment methods theme, you cannot switch back to use or preview a single payment method theme. Choosing the multiple payment methods team allows you to develop and test multiple payment methods prior to converting. You can publish the new multiple payment methods theme when updates are ready.

If you want to update an existing version of Theme Engine, you must create a new theme. This automatically uses the latest template version, and your developer can migrate customizations from the existing theme to the new one.

1. From the merchant portal, click Storefront and select Theme Editor.
2. Click Create new theme or click Edit code to work on an existing theme.
3. If creating a new theme, enter a name in the Theme name field and select the Theme template from the dropdown.
4. Click Create theme.
   

Import a theme

1. From your merchant portal, click Storefront and select Theme Editor.
2. Click Import theme.
3. Upload your Theme asset file (.zip) and click Next.
   
4. Enter a name in the Theme name field and click Import theme.
   

Enable your custom theme

When you are ready to go live with your custom portal theme, you can update the settings on your Customer portal settings page.

1. In the merchant portal, click Storefront and select Customer Portal.
2. In the Customer portal section, select PRO Theme Engine.
3. In the Customer portal location section, select either Hosted by Recharge or Embedded in platform storefront.
   
4. Click Save.