> For the complete documentation index, see [llms.txt](https://eraya.gitbook.io/eraya-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eraya.gitbook.io/eraya-docs/theme-test/theme-tests-how-to-set-up.md).

# 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.