# Theme Tests – Getting Started

### What Are Theme Tests

Theme Tests in **Eraya** let you compare different versions of your Shopify store’s theme to see how design or layout changes impact conversion, engagement, and revenue.\
You can test major visual or UX updates like new product page layouts, banner placements, or checkout designs — all without disrupting your live theme.

***

### When to Use It

Use a Theme Test when:

* You want to measure the impact of design or layout changes.
* You’re planning a major theme refresh and want to validate performance first.
* You want to test third-party app integrations, checkout flows, or visual hierarchy.
* You want to compare seasonal or promotional layouts before fully publishing.

***

### How It Works

1. **Create Variations**\
   Select your **Control Theme** (current live theme) and a **Test Theme** (modified version).
2. **Traffic Split**\
   Eraya divides visitors between the two themes based on your variation percentage.\
   Each visitor consistently sees the same theme for the duration of the test.
3. **One Test at a Time**\
   Only one Theme Test can be active at a time to ensure clean, conflict-free data.
4. **Eraya Script Requirement**\
   Make sure the **Eraya Script** is installed and turned on in both:
   * The **Control (live)** theme
   * The **Test (published)** theme
5. **Theme Validation**\
   Confirm that the theme selected for the variation:
   * Has all required sections, features, and apps properly configured.
   * Matches your test goals (e.g., layout, image style, or UX element differences).

***

### Measuring Analytics

Once your test is live, Eraya automatically tracks:

* Page views
* Conversion rate
* Add-to-cart rate
* Checkout completion
* Average order value (AOV)

All metrics are visible on the **Analytics** page under your selected test.

***

### Implementing Changes

After the test concludes:

* Review analytics and identify which theme performed better.
* Apply winning design elements permanently to your live theme.
* End the test in Eraya to restore default theme behavior.

***

### What Customers See

Based on your traffic split:

* A portion of visitors will see the **Control** theme (existing version).
* Others will see the **Test Variation** theme (new version).

This happens automatically without manual intervention, ensuring an unbiased experiment.

***

### Conclusion

Theme Tests help validate design decisions using real customer behavior.\
They are ideal for ensuring that any visual or UX change truly enhances performance before rolling out site-wide.


---

# Agent Instructions: 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:

```
GET https://eraya.gitbook.io/eraya-docs/theme-test/theme-tests-getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.