Overview
The circuly Subscriptions theme extension adds three blocks to your Shopify storefront:- Unified purchase selector — A subscription widget on product pages that lets customers choose between subscription plans, one-time purchase, rentals, and bundles
- Cross-sell Products — A slim list of complementary products that mirrors the main product’s selected plan. Configured in the app rather than the theme; see the dedicated Cross-sell page
- Bundle progress — A cart-side counter that shows how many bundle slots are left while the customer shops. Used together with Bundles
Unified purchase selector block
The Unified purchase selector block displays your subscription plans on the product detail page. When a product has subscription plans assigned, customers see their options with pricing, frequency, and any applicable discounts.Adding the block to your theme
1
Open the Theme Editor
In your Shopify admin, go to Online Store > Themes, then click Customize on your active theme.
2
Navigate to a product page
In the Theme Editor, use the page selector at the top to switch to a Product page template.
3
Add the block
In the left sidebar, find the product page section and click Add block. Look for Unified purchase selector under the Apps section and select it.
4
Position the block
Drag the block to position it where you’d like it to appear — typically near the “Add to cart” button so customers can select their purchase option before adding to cart.
5
Save
Click Save in the top right corner to publish your changes.
Configuration options
Customize the block’s appearance directly in the Theme Editor sidebar:Subscription bundle card
These settings only apply when a product belongs to a bundle. They control the dedicated bundle card the block renders in place of the normal subscription options.The theme’s own buy buttons
Your theme renders its own Add to cart and Buy it now buttons on the product page. With the Unified purchase selector installed they’re redundant — and they skip the selector’s checks (rental date booking, subscription start date), so a customer could add a rental to the cart without picking any dates. The Hide the theme’s buy buttons setting hides them for you — it’s off by default so your current layout doesn’t change, and we recommend turning it on.Cross-sell Products block
The Cross-sell Products block renders the slim cross-sell list on the product page. Adding it to your theme is the same flow as the Unified purchase selector — pick Cross-sell Products from the Apps section in the Theme Editor. Configuration of which products appear, which are forced one-time, and how mirroring behaves all lives in the app under Cross-sell, not in the theme.Cross-sell setup and behaviour
Configuring cross-sells, frequency mirroring, force-one-time mode, block settings, and eligibility rules.
Bundle progress block
The Bundle progress block lives on the cart page or cart drawer. While the customer is filling a bundle, it shows the bundle name, aN / capacity counter, a progress bar, and a Reset bundle button. Once the bundle is full, the block surfaces a Manage bundle link to the bundle manage page.
If the cart contains no active bundle, the block hides itself — there’s no setup cost to leaving it placed.
Adding the block to your theme
1
Open the Theme Editor
In your Shopify admin, go to Online Store > Themes, then click Customize on your active theme.
2
Navigate to the cart page or drawer
In the page selector at the top of the Theme Editor, switch to the Cart template (or open the cart drawer preview, depending on your theme).
3
Add the block
Click Add block in the cart section and pick Bundle progress under the Apps group.
4
Position the block
Place it above the cart line items so the counter is the first thing the customer sees while assembling the bundle.
5
Save
Click Save in the top right.
The Bundle progress block has no configuration options — it inherits its appearance from your theme. To customise the matching PDP card, use the Subscription bundle card settings on the Unified purchase selector block above.