> ## 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.

# Managing add-ons

> Offer optional or required extras alongside your rental products

Add-ons are extras a customer can attach to a rental at checkout — things like damage protection, cleaning services, or an accessory bundle. Supercycle owns the add-on product in your Shopify store: you configure each add-on and its prices inside Supercycle, and every price is kept in sync as a variant on the underlying hidden Shopify product.

When a customer adds a rental to their cart, any add-ons applied to the selected option appear on the product page. Required add-ons are always attached; optional add-ons are toggled by the customer. The chosen add-on variants are added to the cart alongside the rental line item and are recorded against the fulfilled rental so they show on the order and any related charges.

## Creating an add-on

Add-ons are configured under **Products** > **Add-ons**. Supercycle creates and maintains the Shopify product for you.

<Steps>
  <Step title="Open the Add-ons section">
    In your Shopify admin, navigate to **Supercycle** > **Products** > **Add-ons**.
  </Step>

  <Step title="Create an add-on">
    Click **Create add-on** and give it:

    * **Name** — shown on the product page selector and on line item properties (e.g. `Damage protection`).
    * **Description** — shown to customers underneath the add-on name on the product page. HTML is supported.
    * **Prices** — one or more amounts customers can pick from. Each price becomes a variant on the underlying Shopify product.

    Add-ons need at least one price before they can be saved.
  </Step>

  <Step title="Save">
    Supercycle creates a hidden Shopify product with a `Price` option axis, one variant per price. Inventory tracking is disabled automatically so add-ons are not treated as stock. You can edit the name, description, or prices at any time — changes are synced to Shopify and to every option the add-on is applied to.
  </Step>
</Steps>

## Applying add-ons to a method option

Once an add-on exists, you can attach it to any Calendar, Membership, Subscription, or Resale option.

<Steps>
  <Step title="Open the option">
    In the options table for a method, open the option you want to attach the add-on to.
  </Step>

  <Step title="Enable the Add-ons section">
    Toggle the **Add-ons** section on and tick the add-ons you want to offer.
  </Step>

  <Step title="Choose a price and requirement">
    For each ticked add-on:

    * **Price** — pick one of the add-on's prices. You can also type a new amount and choose **Create price** to add it to the add-on inline — the new variant is created, synced to Shopify, and selected for the option once it's ready.
    * **Requirement** — set to **Optional** (customer chooses whether to add it) or **Required** (always attached, not togglable on the storefront).
  </Step>
</Steps>

Only one price per add-on can be applied to a given option. If you need to offer the same add-on at multiple prices on the same option, create separate add-ons.

### Bulk-applying add-ons

To apply the same add-ons across many options at once, open the options table for a method, tick the options you want to update, and choose **Apply add-ons** from the [bulk actions menu](/documentation/manage/products/managing-method-options).

The set you pick in the modal **replaces** each selected option's current add-ons wholesale. Leave everything unchecked and save to remove all add-ons from the selected options.

## On the storefront

Add-ons applied to the selected option appear underneath the option selector on the product page:

* **Required** add-ons are shown checked and locked, with a **Required** badge next to the title.
* **Optional** add-ons can be toggled by the customer.

Selected add-on variants are added to the cart alongside the rental. If a customer removes an add-on that is required, they cannot check out the rental.

## On rentals and charges

Once an order is processed:

* Each attached add-on is recorded against the fulfilled rental, frozen at the title and price it was sold at.
* Add-ons appear on the rental detail page and are included in the rental's charges so they flow through to reporting and payouts.
* A rental line item that spans multiple cycles (e.g. a subscription renewal) only receives as many add-on records as were actually purchased on the underlying line item.

## Deleting an add-on

Deleting an add-on removes it from every option it was applied to and removes the underlying hidden Shopify product. Existing rentals keep their historical add-on records because those are stored independently of the add-on product.