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

# Theme setup

> Turn on the Supercycle Engine app embed, add the Methods app block, and style them to match your theme

Supercycle adds rental and resale options to your storefront through the Supercycle Engine app embed and app blocks in your theme. You set both up in Shopify's [theme editor](https://help.shopify.com/en/manual/online-store/themes/theme-structure/extend/apps), from <Icon icon="shopify" iconType="solid" /> **[Themes](https://admin.shopify.com/themes)**.

<Info>
  Supercycle works with [Online Store 2.0 themes](https://help.shopify.com/en/manual/online-store/themes/managing-themes/versions). On an older theme you'll likely need a developer to add the blocks.
</Info>

***

## Turn on the app embed

The Supercycle Engine app embed loads Supercycle on every page and is required for the app blocks to work.

<Steps>
  <Step title="Open the theme editor">
    On <Icon icon="shopify" iconType="solid" /> **[Themes](https://admin.shopify.com/themes)**, select **Customize** on the theme you want to add Supercycle to.

    <Frame type="glass" caption="Customize on the current theme opens the theme editor">
      <img src="https://mintcdn.com/supercycle/Omgmq0rsgqX1BZKa/images/screenshots/supercycle-admin/customise-theme.png?fit=max&auto=format&n=Omgmq0rsgqX1BZKa&q=85&s=61374a8f829b9912a861e0132a550287" alt="Shopify's Online Store themes page with the current theme and its Customize button" width="1946" height="1116" data-path="images/screenshots/supercycle-admin/customise-theme.png" />
    </Frame>
  </Step>

  <Step title="Turn on the app embed">
    In the left sidebar, select **App embeds**, then turn on **Supercycle Engine**.

    <Frame type="glass" caption="App embeds in the theme editor sidebar, with Supercycle Engine turned on">
      <img src="https://mintcdn.com/supercycle/Omgmq0rsgqX1BZKa/images/screenshots/supercycle-admin/enable-app-embed.png?fit=max&auto=format&n=Omgmq0rsgqX1BZKa&q=85&s=bfc905bdeb70c76c4154a2f213ffddf9" alt="The theme editor's App embeds panel with the Supercycle Engine toggle turned on" width="1944" height="1280" data-path="images/screenshots/supercycle-admin/enable-app-embed.png" />
    </Frame>
  </Step>

  <Step title="Save">
    Select **Save** before leaving the theme editor.
  </Step>
</Steps>

***

## Add the Methods app block

Supercycle's storefront features are app blocks, so you place them where you want them in your templates. At a minimum, add the Methods app block to your product template: it shows the rental and resale options and drives your theme's **Add to cart** button. For the block's settings, see [Methods app block](/developers/app-blocks/methods).

***

## Update style settings

The **Methods style** section of the Supercycle Engine app embed controls how the Methods block looks on product pages and how requirement pages look when customers follow links from checkout or their account: contract lists, contract signing, and ID verification at `<your_proxy_url>/contracts`, `<your_proxy_url>/contracts/sign`, and `<your_proxy_url>/identity_verification`. Headings and body copy on those pages inherit your theme's typography. Buttons use the embed's **Button class** setting, `button` by default, so they match the rest of your storefront.

<Steps>
  <Step title="Open the theme editor">
    On <Icon icon="shopify" iconType="solid" /> **[Themes](https://admin.shopify.com/themes)**, select **Customize** on the theme you want to edit.
  </Step>

  <Step title="Open the Supercycle Engine settings">
    In the left panel, select **App embeds**, then select **Supercycle Engine** to expand its settings.
  </Step>

  <Step title="Adjust Methods style">
    Under **Methods style**, set the colors, border radius, and **Button class**. The same values apply to Methods blocks and requirement pages.
  </Step>

  <Step title="Save">
    Select **Save**.
  </Step>
</Steps>

***

## Theme setup FAQs

<AccordionGroup>
  <Accordion title="I added the Methods block to my product page but don't see an add to cart button. How do I add it?">
    The Methods app block uses your theme's own **Add to cart** button rather than adding one. Make sure the **Buy buttons** block is in your product template, and remove any dynamic checkout buttons such as **Buy now**.

    <Frame type="glass" caption="The Methods block and the theme's Buy buttons block in the product template">
      <img src="https://mintcdn.com/supercycle/Omgmq0rsgqX1BZKa/images/screenshots/supercycle-admin/add-to-cart-button-methods.png?fit=max&auto=format&n=Omgmq0rsgqX1BZKa&q=85&s=6ea6f58c7cc036ab256746c565d8d815" alt="The theme editor with the Methods and Buy buttons blocks in the product information section, and the Methods block above the Add to cart button on the product page" width="1689" height="956" data-path="images/screenshots/supercycle-admin/add-to-cart-button-methods.png" />
    </Frame>
  </Accordion>

  <Accordion title="Can I change the order of methods on the product page?">
    Yes. Set the display order with custom CSS in your theme, using the `order` property on each method's class:

    ```css Methods order theme={null}
    .supercycle-method--resale {
      order: 1;
    }

    .supercycle-method--calendar {
      order: 2;
    }

    .supercycle-method--membership-join,
    .supercycle-method--membership-overview {
      order: 3;
    }
    ```

    <Frame type="glass" caption="Resale first, then membership, then calendar">
      <img src="https://mintcdn.com/supercycle/XbKBsdX_PulItpyX/images/screenshots/customer-facing/storefront-methods-order.png?fit=max&auto=format&n=XbKBsdX_PulItpyX&q=85&s=4620d4131b7b9b77c5aa84e9d7d90ca7" alt="The Methods app block on a product page showing Buy now, Rent with membership, and Rent one-time in that order" width="578" height="331" data-path="images/screenshots/customer-facing/storefront-methods-order.png" />
    </Frame>
  </Accordion>

  <Accordion title="How can I stop Supercycle from updating the add to cart button?">
    Set a JavaScript variable in your theme:

    * `window.supercycleStopSync = true` stops Supercycle from updating the add to cart button.
    * `window.supercycleStopSync = false` turns it back on.
  </Accordion>
</AccordionGroup>

***

## Theme troubleshooting

<AccordionGroup>
  <Accordion title="Add to cart is disabled on the product page">
    **Why it happens.** The Methods app block controls your theme's **Add to cart** button and keeps it disabled until the selection is complete: a method option with valid dates, stock for those dates, and every required [terms](/documentation/configuration/risk/terms-and-conditions) row ticked.

    **How to fix it.** Check that the product has an active method with at least one option, that the dates picked are available, and that any terms rows are ticked. If the button stays disabled with a valid selection, contact support from the app with the product URL and a screenshot of the product page.
  </Accordion>

  <Accordion title="App blocks don't show up in the theme editor">
    **Why it happens.** The Supercycle Engine app embed is off, or the theme doesn't support app blocks in that template.

    **How to fix it.** Turn on the app embed under **App embeds** and reload the theme editor. If the blocks still don't appear, contact support from the app with your theme name and the template you're editing.
  </Accordion>
</AccordionGroup>
