> 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/compatibility/supported-themes.md).

# Supported themes & compatibility

OPTIS Color Swatch is built to work with most Shopify themes out of the box, with no coding required.

## How compatibility works

The app detects your theme and applies the right configuration automatically, in three layers:

1. **Shopify free themes**: full, dedicated support for the latest **Horizon** theme family and the **Dawn / Online Store 2.0** family.
2. **Premium themes**: 40+ popular paid themes have their own built-in configuration (listed below).
3. **Automatic fallback**: for any other theme, the app uses smart detection to place swatches correctly. This works for the vast majority of themes even if they are not named here.

## Shopify free themes

Full support for Shopify's free themes, including the newest **Horizon** family:

> **Horizon family:** Horizon · Pitch · Atelier · Fabric · Dwell · Heritage · Ritual · Savor · Tinker · Vessel
>
> **Dawn / Online Store 2.0 family:** Dawn · Sense · Craft · Spotlight · Refresh · Studio · Ride · Origin · Taste · Publisher · Crave · Colorblock

## Premium themes with dedicated support

These popular paid themes have their own built-in configuration:

> Beauty · Charge · Concept · Desert · Edge · Editions · Ella · Empire · Enterprise · Envy · Gain · Glozin · Grid · Hello Gorgeous · Impact · Impulse · Kalles · King · Motion · Palo Alto · Peach Melody · Pipeline · Plain Jane · Prestige · Release · Rise · Rokan · Shapes · Showcase · Shrine · Sitar · Sleek · Sofine · Starlite · Stiletto · Symmetry · Trade · Woodmart · Xtra · Yuva · Zendrop

## Works with dynamic content

Swatches keep working even when parts of the page are loaded dynamically. The app watches for content changes and re-renders automatically, so it works with:

* **Quick view / quick shop** popups and drawers
* **AJAX collection loading**, infinite scroll, and "load more"
* Other apps and theme features that inject products into the page after it loads

No manual setup is needed for these in most cases.

{% hint style="info" %}
Building a custom integration? See [Swatch events & app integration](/swatch/developers/swatch-events-and-integration.md) for the JavaScript events and the `runScript` helper to re-render after your own code updates the page.
{% endhint %}

## If your theme is not listed

Even if your theme is not named above, the automatic fallback usually handles it. If swatches do not appear or look out of place:

* Make sure the **app embed** is enabled (see [Quickstart](/swatch/getting-started/quickstart.md) and [Why aren't my swatches showing up on the store?](/swatch/frequently-asked-questions/why-arent-my-swatches-showing-up-on-the-store.md)).
* Heavily customized themes may need a small manual adjustment.

{% hint style="success" %}
**Need help with your theme?** Contact our support team via live chat or email <support@optis.me>. We offer custom setup and theme integration to make swatches work on your store.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.optis.me/swatch/compatibility/supported-themes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.