> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/umbraco-engage/marketers-and-editors/ab-testing/setting-up-the-ab-test.md).

# Setting up the A/B Test

To set up an A/B test in Umbraco Engage you need to go through a series of steps. Learn more about the required configuration is required for initating a test.

Setting up an A/B test in Umbraco Engage requires no code or need for any external tooling.

Starting A/B tests can be done in two ways:

* Initiate a Single Page, Multiple Page, or Document Type test via the Workspace View on the specific page,
* Initiate Multiple Page, Document Type, or Split URL tests via the Engage section.

## Create a project

Every test must belong to a project.

To create a project:

1. Go to **Engage** > **A/B Testing**.
2. Click **Add new project**.
3. Enter the **Name** and **Description** of the new project.
4. Select **Submit**.

![Create a project](https://2164986937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds5IoWmsX6a6ooVdYthx%2Fuploads%2Fgit-blob-11de7eb026b4e483e1ab851951fc5c00fc41593d%2Fcreate-new-project.png?alt=media)

## Set up the test

Open the Umbraco content tree and select the A/B Tests Workspace View on the page.

![You can find the A/B Tests Workspace View on each of the content items in the Content section.](https://2164986937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds5IoWmsX6a6ooVdYthx%2Fuploads%2Fgit-blob-616ceb88beb7fa1c4bc3ef58695a722bdf241faa%2Fengage-a-b-test-content-app-v16.png?alt=media)

Make sure that you have access to the Workspace View. [These permissions can be specified](/umbraco-engage/marketers-and-editors/settings/permissions.md) per Document Types or User Groups.

When you open the Workspace View you will have an overview of all the A/B tests that are running or finished. You also have the option to **Create new test**.

![Use the A/B Tests Workspace View to get an overview of running tests and create new ones.](https://2164986937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds5IoWmsX6a6ooVdYthx%2Fuploads%2Fgit-blob-5f8b789c5d932d25c2aee28adaecc8b09b452469%2Fengage-a-b-test-content-app-overview-v16.png?alt=media)

## Configure the A/B test

A test must belong to a project. Select an existing project with **Choose** in the **Part of project** field. To create a new project without leaving the test, select **+** next to **Choose**.

When you start a new test, you will have to specify the following:

* The Title of the test.
* Part of project.
* Description/hypothesis.

After that, you need to specify which [Goal](/umbraco-engage/marketers-and-editors/settings/setting-up-goals.md) you want to measure, as it is all about optimizing for this goal. For details on how to set up a new goal, see the [Goals](/umbraco-engage/marketers-and-editors/settings/setting-up-goals.md#setting-up-a-new-goal) article. Set the audience that you want to include in the test.

As a final step, you have to specify the type of test and set up the specific test. It is also possible to preview your variant from here.

![An overview of all the configuration options available when setting up an A/B test.](https://2164986937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds5IoWmsX6a6ooVdYthx%2Fuploads%2Fgit-blob-91c2c4b6282eff210282aa812a5e54b8492a7b3e%2Fengage-a-b-test-test-setup-v16.png?alt=media)

## Launching the A/B test

Once you have set everything up the test is ready to go. You can preview the final variants and check if everything set up correct.

If that is the case you can start the test immediately, or schedule it for later.

![Launch the test right away, or schedule it to start at a later point.](https://2164986937-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fds5IoWmsX6a6ooVdYthx%2Fuploads%2Fgit-blob-ee559fc31b2190998acdcc51dfa215c7402e38b7%2Fengage-ab-test-launch-v16.png?alt=media)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.umbraco.com/umbraco-engage/marketers-and-editors/ab-testing/setting-up-the-ab-test.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.