Skip to main content
Supercycle writes metafields to your Shopify products, variants, and customers so your theme can tell which methods a product offers, whether a variant has stock, and what a customer’s membership allows. They all live in the supercycle namespace, and you can see their definitions under Custom data in the Shopify admin.
Supercycle sets these metafields and overwrites them when it syncs. Don’t edit them by hand.

​
Product metafields

Product metafields say whether a product is in Supercycle and how each of its methods is configured.

​
Product configuration

​
boolean
Whether the product is in Supercycle. true once a product is imported, false when it’s removed.
​
integer
The total uncommitted inventory available across all variants.

​
Method configuration

​
list.single_line_text_field
The methods turned on for the product, as an array of names: ["Calendar", "Membership", "Subscription", "Resale"]. The app blocks read it to decide which methods to show.
​
json
The calendar method’s configuration, including its rental periods and fixed fees.
​
json
The membership method’s configuration, including its credit costs.
​
json
The subscription method’s configuration, including its pricing groups.
​
json
The resale method’s configuration.

​
Variant metafields

Variant metafields track availability and membership pricing per variant.

​
Inventory

​
boolean
Whether the variant has inventory that isn’t committed to an active rental. Used to filter collections by stock.
​
number_integer
The number of items on the variant that are visible, so not hidden or retired, and not committed to an active rental.
​
boolean
Whether the variant has availability on future dates. Used by the calendar availability filter.

​
Membership

​
number_integer
The credit cost of the variant when it’s rented on a membership.
​
number_integer
The credit allowance a membership plan variant grants.

​
Customer metafields

Customer metafields carry membership status and payment information.

​
Membership

​
json
The customer’s membership information and quotas.

​
Payment

​
boolean
Whether the customer has a vaulted payment method. Used to validate the payment method in the cart.

​
Read metafields in Liquid

Check which methods a product offers before rendering method-specific markup:
Check for a method
Read a logged-in customer’s membership to show membership-only content:
Check the customer's membership

​
Merchandising with metafields

Metafields also work as conditions in Shopify’s automatic collections. For example, a collection with the condition supercycle.uncommitted_inventory is true shows only products with an item available today.