> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trylora.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure the Shopify theme

> Place the Try On Button, activate Trylora Embed, and select Shopify product media.

The Shopify Theme Installation has two required parts:

* **Try On Button** is a theme app block on product templates.
* **Trylora Embed** is an app embed that loads Trylora across the storefront.

Both must be active on the published theme.

## Place the Try On Button

<Steps>
  <Step title="Open Theme Editor from Trylora">
    In the Trylora app, select **Install Try On Button**. The generated link opens Theme Editor on a product template.
  </Step>

  <Step title="Choose the product section">
    Place the **Try On Button** app block in the product information area where shoppers should see it. Keep one Try On Button block on each supported product template.
  </Step>

  <Step title="Save the theme">
    Select **Save**. A block added only to an unpublished theme does not satisfy the live-theme status check.
  </Step>
</Steps>

## Activate Trylora Embed

<Steps>
  <Step title="Open App embeds">
    In the Trylora app, select **Activate Trylora Embed**. If you navigate manually, open Theme Editor and select **App embeds**.
  </Step>

  <Step title="Enable Trylora Embed">
    Turn on **Trylora Embed**. Choose the button color, button style, corner style, size, and whether to show the floating launcher.
  </Step>

  <Step title="Save and refresh status">
    Select **Save**, return to Trylora, and select **Refresh status**. Both theme components should show `active`.
  </Step>
</Steps>

<Warning>
  Do not paste the Generic Embed script into `theme.liquid`. Trylora Embed already loads the storefront runtime and passes Shopify product-media context to it.
</Warning>

## Select the product image

By default, Trylora uses Shopify product media. To change which image wins:

1. Open **Trylora** in Shopify admin.
2. Select **Open Advanced Settings**.
3. Under **Product images**, choose one option:
   * **First product media image** when the first product-only garment image should win.
   * **Product featured media** when the featured image is the intended garment image.
   * **Selected variant media** only when each variant has its own garment image.
4. Select **Save product image source**.

<Tip>
  If a custom theme needs DOM selector fallbacks, configure them in the Trylora dashboard under the store's advanced settings. Keep Shopify product media as the primary source whenever possible.
</Tip>