> For the complete documentation index, see [llms.txt](https://docs.optis.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.optis.me/swatch/getting-started/quickstart.md).

# Quickstart

{% stepper %}
{% step %}

### Activate the app

* In the **App Dashboard**, go to **Setup Guide** → click **Activate the app**

→ You’ll be redirected to **App Embed** in the Shopify Theme Editor

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-22c6d15a5212cbd0cacc854a2b84894f754540ec%2Fquickstart-app-embed-theme-editor.png?alt=media" alt="OPTIS Color Swatch App embed in the Shopify Theme Editor"><figcaption></figcaption></figure>

* Turn on the toggle and click **Save**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-cc8e362c28440d5bca45592ae053b41827621734%2Fquickstart-app-embed-toggle-save.png?alt=media" alt="App embed toggle turned on, with the Save button"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Optional (Recommended for testing):** If you want to enable the app on a draft theme instead, go to **Online Store → Themes → Edit theme (selected theme) → App embeds**, then enable the **OPTIS Swatch** app toggle and click **Save**.

*This allows you to fully test the app without affecting your live store.*
{% endhint %}
{% endstep %}

{% step %}

### Configure your Shopify variants

* Make sure your products have variants (e.g. Color, Size) → Click **Configure variants** to open **Variants Display**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-16fd7a7ad181744f53b88e07e541c72258f39f5d%2Fquickstart-configure-variants-button.png?alt=media" alt="Configure variants button opening the Variants Display page"><figcaption></figcaption></figure>

* Here, you can customize how variants are displayed on Product pages and Collection pages - Choose the display type that fits your store design

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-941b5b29cbaafc041063843d5dd02cd5a1c311bb%2Fquickstart-variants-display-types.png?alt=media" alt="Variants Display page with display type options for product and collection pages"><figcaption></figcaption></figure>

👉 **Click here to learn** [**How to change the variant display**](/swatch/variant-display/auto-image-swatch.md)
{% endstep %}

{% step %}

### Make it yours! (optional)

* Click **Style your variants** to open the **Styling Dashboard**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9f4cb28aabf3af7b2204d3f367ee0ce4c85f3c04%2Fquickstart-style-your-variants-button.png?alt=media" alt="Style your variants button opening the Styling Dashboard"><figcaption></figcaption></figure>

* Customize how variants look on your store, including size, alignment, colors, spacing, hide extra swatches,...

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-e1c526e215d1d511a409501d3243d79fdede7d24%2Fquickstart-styling-dashboard.png?alt=media" alt="Styling Dashboard with size, alignment, color, and spacing options"><figcaption></figcaption></figure>

👉 **Click here to learn** [**How to customize the swatches' look**](/swatch/frequently-asked-questions/is-it-possible-to-customize-how-swatches-look.md)
{% endstep %}
{% endstepper %}

You're all set! 🎉\
Continue to the next sections to explore advanced settings and customization options.