> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abconvert.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Visual Editor Test: Getting Started

> A/B test storefront content like headlines, images, and buttons to improve conversion rate without touching theme code.

## What is a visual editor test?

A visual editor test allows you to create A/B tests directly on your Shopify storefront without touching theme code. Using the built-in visual editor, you can modify text, images, buttons, links, and page elements for different visitor groups.

This helps you validate design and messaging changes before permanently updating your store. Visual editor tests are ideal for testing conversion-focused improvements quickly while keeping your original theme intact.

## Visual editor test use cases

* **Test homepage headlines:** Compare different messaging to improve conversion rate.
* **Experiment with CTA buttons:** Test button text, links, or placement.
* **Validate product page layouts:** Hide or reorder sections to improve engagement.
* **Test promotional banners or images:** Compare creative assets during campaigns or seasonal promotions.

## Set up a visual editor test

<Steps>
  <Step title="Create a new visual editor test">
    In the ABConvert dashboard, click **Create New Test** and select **Visual Editor Test**.
  </Step>

  <Step title="Add basic information and configure traffic split">
    Enter a descriptive name for your experiment, write a clear hypothesis, and select your primary success metric. By default, traffic is split evenly between the Control and Variant groups. You can adjust the traffic allocation or add additional variants.
  </Step>

  <Step title="Configure your audience">
    Define which visitors should enter the experiment using audience targeting and traffic allocation rules. Read more in the [Audience targeting](/experiments/audience-targeting) guide.
  </Step>

  <Step title="Open the visual editor">
    In Step 3 of the setup wizard, click the **Edit** button with the pencil icon to open the visual editor.

    <Frame>
      <img src="https://mintcdn.com/abconvert/vg6tMZOym4fryMSB/images/CleanShot-2026-05-26-at-14.47.53@2x.png?fit=max&auto=format&n=vg6tMZOym4fryMSB&q=85&s=95fe01d54f985f7dcdf856bb86b8e71c" alt="Clean Shot 2026 05 26 At 14 47 53@2x" width="2200" height="1502" data-path="images/CleanShot-2026-05-26-at-14.47.53@2x.png" />
    </Frame>
  </Step>

  <Step title="Edit your storefront">
    Update your variant in the visual editor, see the section Using the visual editor for more detailed guide.
  </Step>

  <Step title="Review and launch">
    Review your full experiment configuration, including the visitor flow and visual changes. We recommend using **Preview test** to check your changes on the storefront before launching. When everything looks correct, click **Launch test**.
  </Step>
</Steps>

## Using the visual editor

### The top bar

At the top of the editor, you will see several controls. From left to right:

1. **Variant switcher:** Switch between the **Control** and different variant groups
2. **URL bar:** Type a URL to navigate to another page within your store
3. **Select element button:** Turn this on to activate **Select mode**
   * When enabled, you can click elements and edit them
   * When disabled, you can browse your store normally
4. **Device switcher:** Preview your store on desktop, tablet, or mobile screen sizes
5. **Save button:** Click **Save** to keep your changes

<Frame>
  <img src="https://mintcdn.com/abconvert/vg6tMZOym4fryMSB/images/CleanShot-2026-05-26-at-14.58.39@2x.png?fit=max&auto=format&n=vg6tMZOym4fryMSB&q=85&s=13413cb81ccb44ee883bd8eb5c010128" alt="Clean Shot 2026 05 26 At 14 58 39@2x" width="2612" height="860" data-path="images/CleanShot-2026-05-26-at-14.58.39@2x.png" />
</Frame>

### Edit elements in select mode

When **Select mode** is active:

* Move your cursor over the page
* Elements will be outlined as you hover
* Click an element to select it

<Frame>
  <img src="https://mintcdn.com/abconvert/vg6tMZOym4fryMSB/images/CleanShot-2026-05-26-at-15.00.21@2x.png?fit=max&auto=format&n=vg6tMZOym4fryMSB&q=85&s=55bfa26ebcc1000bad2da736cd93cf1b" alt="Clean Shot 2026 05 26 At 15 00 21@2x" width="1842" height="876" data-path="images/CleanShot-2026-05-26-at-15.00.21@2x.png" />
</Frame>

After selecting an element, **right-click** to see editing options:

* **Edit**: Depending on the element type, you can:
  * Edit text: Update the text in the input field, then click Save
  * Change link: Enter a new URL for buttons or linked text
  * Change image: Choose an image from your library, upload a new one, or paste an image URL
* **Move up** or **move down**
  * Reorder the element within the same hierarchy level
  * For example, move a product card to the first position in a grid
  <Note>
    Note: You can only reorder elements within the same parent container
  </Note>
* **Hide element**
  * Hide the selected element from the page without deleting it in Shopify
* **Select parent**
  * Quickly jump to the parent container if you need to edit a larger section

<Frame>
  <img src="https://mintcdn.com/abconvert/vg6tMZOym4fryMSB/images/CleanShot-2026-05-26-at-15.01.33@2x.png?fit=max&auto=format&n=vg6tMZOym4fryMSB&q=85&s=6fd35fb3d55b2a894ee671612682dd3d" alt="Clean Shot 2026 05 26 At 15 01 33@2x" width="1470" height="948" data-path="images/CleanShot-2026-05-26-at-15.01.33@2x.png" />
</Frame>

### The right-side panel

When an element is selected, the right panel gives you more controls.

* **Properties**:
  * View the element tree structure
  * Note: You can see up to three levels above the selected element
* **Edit options**: You will see the same editing options here, this is useful if you prefer using the side panel instead of right-clicking
  * Edit text
  * Change link
  * Change image
* **Custom code**
  * Click **Add code** to insert custom **CSS** or **JavaScript**
  * This applies at the **site level,** not just one page. Use this for advanced customizations
* **Changes**
  * This section shows all edits made in each variant group
  * Click the **trash icon** to remove a specific change

<Frame>
  <img src="https://mintcdn.com/abconvert/vg6tMZOym4fryMSB/images/CleanShot-2026-05-26-at-15.19.52@2x.png?fit=max&auto=format&n=vg6tMZOym4fryMSB&q=85&s=dd4dea326d19f3b2884dbd31892f03d4" alt="Clean Shot 2026 05 26 At 15 19 52@2x" width="1774" height="1380" data-path="images/CleanShot-2026-05-26-at-15.19.52@2x.png" />
</Frame>

<Tip>
  For each change, you can click the **edit icon** to get more control over where the change appears in your store.

  <Frame>
    <img src="https://mintcdn.com/abconvert/vg6tMZOym4fryMSB/images/CleanShot-2026-05-26-at-15.14.47@2x.png?fit=max&auto=format&n=vg6tMZOym4fryMSB&q=85&s=fe2bba5a8fab6299a695963b86d96edb" alt="Clean Shot 2026 05 26 At 15 14 47@2x" width="1406" height="998" data-path="images/CleanShot-2026-05-26-at-15.14.47@2x.png" />
  </Frame>
</Tip>

## Visual editor test FAQs

<AccordionGroup>
  <Accordion title="Do I need coding knowledge to use the visual editor?">
    No. The visual editor is designed for non-technical Shopify merchants. Most changes can be made directly through the editor interface without touching code.
  </Accordion>

  <Accordion title="Can I test mobile-specific changes?">
    Yes. You can preview your storefront on desktop, tablet, and mobile devices while building your experiment.
  </Accordion>

  <Accordion title="Will visual editor tests affect my Shopify theme files?">
    No. Your original Shopify theme files remain unchanged.
  </Accordion>

  <Accordion title="Can I use custom CSS or JavaScript in visual editor tests?">
    Yes. You can add custom CSS or JavaScript using the Custom code section in the right-side panel.
  </Accordion>

  <Accordion title="Can I undo changes inside the editor?">
    Yes. The Changes panel shows all edits made in the current variant. You can remove individual changes at any time before launch.
  </Accordion>

  <Accordion title="Are there any limitations for the visual editor?">
    The visual editor works with most standard Shopify themes. However, there are a few things to keep in mind:

    * **Dynamically rendered elements** (e.g., content loaded via JavaScript after page load) may not be selectable or editable.
    * **Third-party app elements** may have limited editability depending on how they are rendered.
  </Accordion>
</AccordionGroup>
