---
title: "Create browser tests from plain-language user journeys | Grafana Cloud documentation"
description: "Use Agentic testing in Grafana Cloud to create resilient browser tests from plain-language user journeys without writing test scripts."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Create browser tests from plain-language user journeys

> Caution
> 
> On October 26, 2026, the experimental **Agentic testing** app is removed from Testing & synthetics. You won’t be able to view, edit, or re-run the tests it generated, and you can’t export those test definitions.
> 
> We’re rebuilding Agentic testing as a dedicated experience that works with Grafana Assistant. Recreate any journeys you still need before that date. Results from past runs stay in the Agentic Testing project until your retention window ends.

Create a functional browser test by setting a start URL, adding plain-language steps, and saving the test in Grafana Cloud. For an overview of Agentic testing, refer to [Introduction to Agentic testing](../introduction/).

## Before you begin

To use **Agentic testing**, you need:

- A [Grafana Cloud account](/auth/sign-up/create-user)
- Access to **Testing & synthetics** > **Agentic testing** in your stack. By default, only [Grafana Cloud Admins](/docs/grafana-cloud/account-management/authentication-and-permissions/cloud-roles/) have access. Refer to [Projects and access](../introduction/#projects-and-access) to grant access to other users.
- [Grafana Assistant](/docs/grafana-cloud/assistant/) enabled on your stack

Contact your Grafana Cloud administrator if you don’t see **Agentic testing** in the main menu.

## Create a browser test

To create a browser test:

1. Sign in to your Grafana Cloud stack.
2. On the main menu, click **Testing & synthetics** > **Agentic testing**.
3. Click **+ Create a new test**.
4. In **Start URL**, enter the full URL where the browser opens first.
   
   For example, enter `https://quickpizza.grafana.com/admin`. QuickPizza is Grafana’s demo site, so you can run this example without setting up your own application.
5. In **User Journey**, add one action or check per step in plain language. Steps run in order after the start URL opens.
   
   For example, enter one line per step:
   
   text ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```text
   Fill username with admin
   Fill password with admin
   Click Sign in
   Verify the page shows Latest pizza recommendations
   ```
   
   > Tip
   > 
   > Enter the action text only in each step field. The UI numbers steps for you, so don’t include `1.`, `2.`, and so on in the step text.
   
   Each step supports up to 300 characters. A test supports up to 20 steps. Refer to [Introduction to Agentic testing](../introduction/#test-limits) for the full list of test limits.
6. In **Test name**, enter a name that describes the journey, for example, `QuickPizza admin login`.
7. Click **Save**, or click **Save and run** to save the test and start a run immediately.

To store logins, API keys, or other sensitive values, [create a secret](../create-and-manage-secrets/) and reference it as `${secret:SECRET_NAME}` in your journey steps.

## Run a browser test

If you clicked **Save and run** when you created the test, Grafana Cloud starts the run immediately. Otherwise, to run a saved browser test:

1. Open the test you created.
2. Click **Run**.

**Agentic testing** runs one functional browser session on Grafana Cloud. Each step executes in a real browser, not as a protocol-only or uptime check. A single run can take up to 15 minutes.

While the test runs, you can follow live progress in the run view, including the current step and browser logs.

## Review test results

When the run finishes, review the results to confirm whether the journey passed or failed. A completed run shows the overall status, how many steps passed, and a **View recording** option.

Each run includes:

- **Step-level pass/fail results** for every step in the user journey
- **Logs** that show what happened during the run
- **A session recording** you can replay to see the browser interaction

Use these artifacts to debug failures, share outcomes with your team, and iterate on the journey description without rewriting a full browser test script.

### Debug a failed run

Expand the failed step to follow the agent’s reasoning and the tools it called. Click **View recording** to replay the browser session, and check the logs for the run. Revise the step wording in your user journey and run the test again.

If you can’t save a test, confirm you have access to **Agentic testing**. By default, only [Grafana Cloud Admins](/docs/grafana-cloud/account-management/authentication-and-permissions/cloud-roles/) can create tests. Refer to [Projects and access](../introduction/#projects-and-access).

For additional context on browser result views in Performance testing, refer to [Inspect browser test results](/docs/grafana-cloud/testing/k6/analyze-results/inspect-browser-test-results/).