The Subscription Widget empowers you to take your subscription offerings on the Shopify product page to the next level through a highly customized customer experience.

This guide highlights the Subscription Widget’s key features, plus provides set-up instructions and things to consider. 

Before you start

• This guide refers to the Subscription Widget (formally known as Subscription Widget 2.0). See Legacy Widget for information on the Legacy Widget (formally known as Subscription 1.0).

• The Subscription Widget is available to stores that meet the following criteria:

  • Utilizes Product Subscription Plans
    • To confirm your store is using Product Subscription Plans, refer to How to confirm your store uses Product Subscription Plans
  • Has a Shopify 2.0 theme published
    • To confirm that you have a published Shopify 2.0 theme, refer to Confirming the version of your Shopify theme
• A/B testing and widget analytics are only available to Pro and Custom plan stores
• You can only use one subscription widget on a specific product template at a time
• You must disable the Legacy Widget when you enable the Subscription Widget

Key features

Starter and pro widget offerings

The Recharge Subscription Widget is available to all merchants, with additional features available depending on your plan type:

• Starter plan merchants: Use the Subscription Widget, which includes a built-in template that can be customized and styled to match your branding and enhance the customer experience.
• Pro and Custom plan merchants: Use the same Subscription Widget as Starter plan merchants, with additional advanced features, including the ability to perform A/B testing and track analytics on all product templates, products, flows, and A/B paths.

Customize the widget directly in Recharge

Customize the widget’s styling and labels, highlight your subscription offering using your preferred phrasing, and even more now directly in Recharge.

You create and design your widget in Recharge’s flow canvas, allowing for more in-depth customizations and greater control.

A/B testing and analytics

Pro and Custom plan stores have access to the Advanced Subscription widget, featuring A/B testing and analytics so that you can build and monitor the subscription widget experience and release enhancements based on customer data.

With A/B testing, you can add the A/B test node to the canvas to create two separate widgets and see which one resonates best with your customers. To understand your customers' preferences you can create two widgets and try:

• Using different wording to highlight subscription savings
• Testing alternating default selections
• Implementing different color schemes

Review your widget analytics, to understand how your customers interact with the widget, and use the data filters to get granular insights.

Use cases

Review the following use cases to understand how other merchants leverage the Subscription Widget:

Set-up instructions

See How to customize the Subscription Widget for detailed set-up instructions. 

Considerations

Consider the following when using the Subscription Widget or Advanced Subscription Widget:

Consideration	Notes
Bundles	Dynamic bundles uses its own widget to display the bundles option to customers. Fixed-price and Preset bundles use the Subscription Widget. You can create a bundles-specific product page template, and then design a widget to display on this template that specifically highlights the benefits of your bundled products.
Product Subscription Plans	You must have Product Subscription Plans enabled to use the Subscription Widget. Follow the instructions listed on How to convert to Product Subscription Plans if you wish to upgrade to use the widget. The widget respects the sort order of your product subscription plans set for a product. The plans list on the widget resets if you change the order of the product's plans. You cannot select specific frequencies to display first, instead at this time frequencies are preselected.
Page builder apps	Page builder apps such as Pagefly and Shogun are not compatible with the Subscription Widget out-of-the-box.
Shopify themes	The Subscription Widget is compatible with all free Shopify themes, and most paid Shopify themes See Subscription Widget app block not appearing in the Shopify Theme Editor if you are unable to see the app block.
Shopify Markets	You can completely translate the Subscription Widget, and it is compatible with Shopify Markets. See How can I translate the Subscription Widget? for more information.
Price label	The price label on the product page does not update when switching between one-time and subscription options due to a Shopify limitation. The price does display on the widget to help prevent customer confusion.
Payment	If you use manual payment capture or authorization capture on Shopify, the order isn't paid at checkout. In these cases, widget analytics only reflect the checkout information after you successfully capture the payment.

Resources

Getting Started resources

• Getting started with the Subscription Widget

Set-up instructions

• How to customize the Subscription Widget
• How to create different widgets for individual products using product templates in Shopify using the Subscription Widget

Troubleshooting resources

• Subscription Widget not visible on the product page in the Shopify Theme Editor

Frequently Asked Questions

• Subscription Widget FAQs

Developer Docs

• How to update the Subscription Widget using CSS