How do I use Recurly Commerce theme app embeds and blocks?

Use Shopify’s Theme Editor to enable the Recurly Commerce Subscriptions embed block, and optionally place inline blocks for more control on OS 2.0 themes.

Before you begin

• The app embed block is required for all themes

• Inline blocks are only supported on Shopify OS 2.0 themes

• Custom styling is not available yet

Enable the required app embed block

1. Go to Online Store → Themes → Customize

2. In the left sidebar, click Theme Settings → App Embeds

3. Toggle Recurly Commerce Subscriptions Widget to On

4. Click Save in the top right corner

This activates the widget scripts across your storefront

Remove the app embed block

1. Go to Theme Settings → App Embeds

2. Toggle Recurly Commerce Subscriptions Widget Off

3. Click Save

This removes all storefront subscription components

Add an inline app block (OS 2.0 themes only)

1. In the Theme Editor, navigate to a product page with an active subscription

2. In the left sidebar, expand Product Information and click Add block

3. Under Apps, choose Recurly Commerce Subscriptions Widget

4. Drag the block where you want it (e.g., above the Buy button)

5. Click Save

Remove an inline app block

1. In the product template, select the Recurly Commerce Subscriptions Widget block

2. Click Remove block

3. Click Save

Inline blocks let you control exactly where the widget shows on your product pages. Custom styling options are coming soon.

For more details, visit our Recurly Commerce Product Documentation.