MutationObserver to maintain button state even if other scripts modify it.\
It also supports AJAX carts by injecting rental data before submission.
sections/main-product.liquidsections/product-template.liquidtemplates/product.liquid (very old themes)Monthly recurring payment: {{ total_recurring_payment | money }}
``` ### Line item plan details Add this block inside your cart item loop to show each product's plan name, first payment, and recurring payment. ```liquid theme={null} {%- if item.selling_plan_allocation and item.selling_plan_allocation.selling_plan -%}Plan: {{ item.selling_plan_allocation.selling_plan.name }}
{%- assign adjustments = item.selling_plan_allocation.selling_plan.price_adjustments -%} {%- for adjustment in adjustments -%} {%- if adjustment.order_count == 1 -%}First payment: {{ adjustment.value | divided_by: 100 | money }}
{%- elsif adjustment.order_count == null -%}Recurring payment: {{ adjustment.value | divided_by: 100 | money }}
{%- endif -%} {%- endfor -%}No. The arrival date does not update based on tracking information.\ It’s calculated using your configured logistics buffers.
To change the shipping address for an existing order, go to the order in Shopify.\ Click the **three dots** next to the customer’s name, then select **Edit address**.\ Any changes you make will automatically be reflected in Supercycle.
When you create a rental order from the **Cycles** tab in Supercycle and click **Save**, you’re taken to a Shopify **draft order**. Add a **customer** and **process the payment** on that draft order. After payment is captured, the cycle appears in **Cycles** in Supercycle.
This happens when you update a variant via CSV in Shopify. Shopify replaces the variant ID but doesn't notify Supercycle, so the items lose their link to the original variant.
To re-link the affected items:
| Column | Purpose |
|---|---|
| Item | Unique ID for the item (for example, #2001). New ID = new item. Existing ID = update that item. |
| Variant Shopify ID | Links the item to its Shopify product variant. |
| SKU | Stock keeping unit. Recommended even if Variant ID is included. |
| Visibility | Sets whether the item is available or unavailable. |
| Status | Workflow state, such as processed, unprocessed, or retired. |
unavailableretired| Column | Purpose |
|---|---|
| Item | Unique ID for the item (for example, #2001). New ID = new item. Existing ID = update that item. |
| Variant Shopify ID | Links the item to its Shopify product variant. |
| SKU | Stock keeping unit. Recommended even if Variant ID is included. |
| Visibility | Sets whether the item is available or unavailable. |
| Status | Workflow state, such as processed, unprocessed, or retired. |
unavailableretiredYou can also use [Liquid formulas](/documentation/manage/products/managing-method-options) to update existing options in bulk without CSV import. This is useful for applying consistent changes like price increases across multiple options.
We create a corresponding Shopify product when you create a membership plan in Supercycle to handle billing.
The plan title is the Shopify product title and is displayed in the cart, checkout, transactional emails, and orders in Shopify admin.
The maximum number of credits (or items) that a customer can spend at any one time.
The order and return allowances determine how often a customer can swap items on their membership.
Allowances are aligned with the billing anniversary but you can set a different cadence.
For example, a customer is on a plan that is billed monthly and they took the membership out on 1 January.\ You’ve set the swap allowance so they are allowed 1 order and 1 return every 3 months.\ They take 3 items out on 1 January and can return them anytime, but their order allowance won’t reset until 1 April,\ meaning they can’t rent new items until then. They’ll continue to be billed monthly on 1 February and 1 March.
Swap allowances protect your margins. The majority of rental costs are in logistics, so it’s best to balance customer flexibility with cost control.\ In an ideal membership, the customer keeps the same item indefinitely.
Purchase options define the different billing cycles you want to offer your customers.
A plan can have multiple purchase options.
For example, you may offer a plan on a £50 monthly payment or a £500 yearly payment,\ giving customers the equivalent of 2 months free in exchange for a 12-month commitment.
The billing cycle a customer chooses doesn’t affect how regularly they can swap items.
The option name is shown on the selector on the product page and on the line item properties in the cart and at checkout.
The price customers will pay to purchase the item. This is a one-time payment that transfers ownership of the item to the customer.
Control whether this option is available for customers to select. Disabled options won't appear on the product page.
Choose which product variants this pricing option applies to. You can apply it to all variants or select specific ones.
Choose which item conditions this pricing option applies to. You can apply it to all conditions or select specific ones (new, good, fair, poor).
If you sell across multiple Shopify markets, you can target this option to specific markets only. Leave it set to all markets to show the option everywhere. See [Multi-market pricing](/documentation/manage/products/multi-market-pricing) for details.
Turn on the resale method for each new inventory item.
The pricing group's is shown on the selector on the product page and on the line item properties in the cart and at checkout.
The price is the recurring billing amount, starting from the rental start date. The initial charge is charged at checkout - other merchants use this as a joining or administration fee.
If you've [created deposit amounts](/documentation/configuration/risk/deposits), you can select one here to be added to the cart with the subscription.
Supercycle will link the deposit and subscription together throughout the lifetime of the rental.
You can define the minimum term as any period. The minimum term begins from the rental start (usually the fulfillment time).
Once a customer has rented the item for the minimum term, they will be able to initiate a return. As a merchant, the minimum term is displayed in Supercycle as advisory but you are able to override it.
You can apply pricing groups to all or specific variants. This works well for different storage sizes on electronics or different conditions, for example.
If you sell across multiple Shopify markets, you can target this pricing group to specific markets only — for example to charge different recurring amounts in different currencies or regions. Leave it set to all markets to show the group everywhere. See [Multi-market pricing](/documentation/manage/products/multi-market-pricing) for details.
This order contains a subscription. Manage your subscription
{% else %}Thank you for your order
{% endif %} ``` ### Order vs recurring subscription Order Use to display different content if it's a recurring order. Recurring orders created by Supercycle include a `rental_id` line item property — the original checkout order doesn't. ```liquid Email body theme={null} {% assign is_recurring = false %} {% for line_item in line_items %} {% for prop in line_item.properties %} {% if prop.first == 'rental_id' %} {% assign is_recurring = true %} {% endif %} {% endfor %} {% endfor %} {% if is_recurring %}Thank you for your subscription order
{% else %}Thank you for your order
{% endif %} ``` To change the email subject too, paste this whole snippet — including the detection loop — into the **Email subject** field. It's the same check, written with `{%-` whitespace control so the subject renders as a single line: ```liquid Email subject theme={null} {%- assign is_recurring = false -%} {%- for line_item in line_items -%} {%- for prop in line_item.properties -%} {%- if prop.first == 'rental_id' -%}{%- assign is_recurring = true -%}{%- endif -%} {%- endfor -%} {%- endfor -%} {%- if is_recurring -%} Thanks for your subscription order, {{ customer.first_name }} {%- else -%} Thanks for your order, {{ customer.first_name }} {%- endif -%} ```Start date: {{ start_date }}
{% endif %} {% if end_date != '' %}End date: {{ end_date }}
{% endif %} ``` You can incorporate this into Shopify's default notifications to display the dates in the product list if your template isn't outputting the line item properties. #### Adding rental dates to staff notifications To display rental start and end dates in staff notifications (like "New order" notifications), add this code within the line item loop in your notification template: ```liquid theme={null} {%- assign rental_start_date = '' -%} {%- assign rental_end_date = '' -%} {%- for prop in line.properties -%} {%- if prop.first == 'Start date' -%} {%- assign rental_start_date = prop.last -%} {%- elsif prop.first == 'End date' -%} {%- assign rental_end_date = prop.last -%} {%- endif -%} {%- endfor -%} {%- if rental_start_date != '' or rental_end_date != '' -%}
Rental details
{%- if rental_start_date != '' -%}
Start date: {{ rental_start_date }}
{%- endif -%}
{%- if rental_end_date != '' -%}
End date: {{ rental_end_date }}
{%- endif -%}
You have been charged: {{ charge_reason }}
{% else %}Thank you for your order
{% endif %} ``` # Supercycle notifications Source: https://docs.supercycle.com/supercycle-notifications Customize and configure Supercycle's transactional customer email notifications Supercycle has email notifications that are sent to the customer. Notifications are triggered by events, like a new return being requested, or credits being recredited. ## Customer email notifications These emails are sent to your customers when certain events occur: