# Theme Tests – How to Set Up

This guide walks you through setting up a Theme Test in **Eraya**, from creating your test to launching it live on your store.

***

### Step 1: Name and Description

In this step, you define the identity and purpose of your test.

**Fields:**

* **Test Name:**\
  Choose a clear, descriptive name for your Theme Test (e.g., *Homepage Layout Experiment*).
* **Description (Optional):**\
  Write your hypothesis or goals. Example:

  > “We believe that updating the homepage banner layout will increase add-to-cart rate by 10%.”

Click **Next** once completed.<br>

<figure><img src="/files/Mv2blQAgMr3dAnIqVIOv" alt=""><figcaption></figcaption></figure>

***

### Step 2: Configure Test Variations

Set up the test variations and control traffic allocation.

**Fields:**

* **Control:** The live version of your store (baseline).
* **Variation 1:** The modified version of your theme.
* **Traffic Allocation:** Divide visitor traffic (default 50/50).

> 💡 You can use **Auto-Distribute** to balance traffic between all variations.\
> Currently, up to one variation can be tested at a time.

Click **Next** to continue.

<figure><img src="/files/8GSWoP6P3mltrZfHbTZ9" alt=""><figcaption></figcaption></figure>

***

### Step 3: Configure Theme Test

Select which themes to associate with each variation.

* **Control Theme:** Automatically set to your published Shopify theme.
* **Variation Theme:** Select your edited or alternate theme version for testing.\
  Make sure this theme includes all required features, apps, and code snippets (including the **Eraya Script**).

Click **Next** to proceed.

<figure><img src="/files/SGUDYM81fxneQejwcLXI" alt=""><figcaption></figcaption></figure>

***

### Step 4: Targeting

Define who should see each version of the theme.

#### **Device Targeting**

Choose the devices included in the test:

* ✅ Mobile
* ✅ Desktop
* ✅ Tablet
* Or select **All Devices**

#### **Visitor Type**

* **All Visitors** – Default option (recommended)
* **New Visitors Only** – Ideal for first-impression tests
* **Returning Visitors Only** – For evaluating changes on existing customers

Click **Next** to continue.

<figure><img src="/files/D3hsWXFfPiZq3XIiTJko" alt=""><figcaption></figcaption></figure>

***

### Step 5: Review & Launch

Review all your configuration details before starting the test.

**Review Sections:**

* **Test Details** – Confirms name and description
* **Theme Configuration** – Displays selected themes and their traffic percentages
* **Targeting** – Lists selected devices and visitor filters

When everything looks correct, click **Launch Test** to start.

<figure><img src="/files/fXbrvIMviPI2GK6m5DZk" alt=""><figcaption></figcaption></figure>

***

### After Launch

Once launched:

* Eraya automatically splits traffic according to your allocation.
* Analytics begin tracking immediately — including conversion, engagement, and revenue.
* You can monitor performance from the **Analytics Dashboard**.

***

### Tips for Successful Theme Tests

* Ensure both the **control** and **variation** themes have **Eraya Script** enabled.
* Keep only one active Theme Test at a time.
* Run each test for a statistically valid duration (at least 2–3 weeks of traffic).
* Apply winning changes to your live theme once results are conclusive.


---

# 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-how-to-set-up.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.