Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.supercycle.com/llms.txt

Use this file to discover all available pages before exploring further.

Bundles let you group multiple products into a single rentable item, so customers can rent a set of components (for example a suit made up of a jacket, trousers, and waistcoat) as one product.
Bundles require development work to build a custom storefront experience using the Storefront API. See Create rental bundles for the full implementation guide.
Bundles are available on request. Contact your Supercycle account manager to enable the feature for your store.

How bundles work

A bundle is a parent product made up of one or more component products. Each component keeps its own methods, options, and inventory — the bundle simply groups them so they can be rented together. When a customer rents a bundle:
  • Each component is added to the cart as its own line item with the correct Supercycle attributes.
  • Availability is checked across all components for the selected dates.
  • The customer selects an option (for example a rental period) for each component.

Set up a bundle

1

Navigate to Bundles

In your Supercycle dashboard, go to Products and select Bundles.
2

Create a new bundle

Click Create bundle and give it a name.
3

Add component products

Add each product that makes up the bundle. Before adding a component, make sure it has the relevant methods enabled in Supercycle — the methods configured on each component determine which options are available at checkout.
4

Save the bundle

Save the bundle. Supercycle will tag the parent product as Supercycle bundle product and each component with Bundle component: <parent-product-handle>, and attach the supercycle.bundle metafield to the parent.

Build the storefront experience

Bundles do not render automatically on the storefront. A developer needs to build the frontend experience using the Storefront API to:
  • Read the bundle metafield and component configurations.
  • Check availability for all components.
  • Create an intent for each component.
  • Add every component to the cart in a single request.
See Create rental bundles for the full developer guide, including code examples for Liquid, the availability check, intent creation, and cart integration.