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

# Test Suites

> Test suites are a grouping of tests on Docket

### Test Suite

Test suites are collections of tests on Docket. They are used to organize tests into logical groups that you might want to run together.

> **Next Step**: After creating a test suite, you can [create individual tests](/essentials/test-creation) to add to the suite.

### Creating a test suite

To create a test suite, navigate to the test suites tab.

<img src="https://mintcdn.com/docket-dcd24ade/Kks4baIOAtT7fIac/images/Screenshot2025-07-17at3.52.48PM.png?fit=max&auto=format&n=Kks4baIOAtT7fIac&q=85&s=21ce81f1e976beb81787b17249dbfbc1" alt="Screenshot 2025-07-17 at 3.52.48 PM.png" width="514" height="370" data-path="images/Screenshot2025-07-17at3.52.48PM.png" />

From there, click the "New Test Suite" button and give your test suite a suitable name.

<img src="https://mintcdn.com/docket-dcd24ade/6ERPSbJA4dmUnadD/images/Screenshot_2025-07-27_at_4.03.55_PM.png?fit=max&auto=format&n=6ERPSbJA4dmUnadD&q=85&s=83433c05b8aa047c774fe466682a14fc" alt="Screenshot 2025-07-27 at 4.03.55 PM.png" width="1026" height="1326" data-path="images/Screenshot_2025-07-27_at_4.03.55_PM.png" />

### Accounts

Think of accounts as username and password configurations that Docket uses to log in. You can assign accounts to test suites, which will then use that account to authenticate for all tests in the suite.

Docket will navigate to the provided URL and log in with the credentials. The browser state (cookies, local storage) that results from this login will be copied as the starting point for all other test runs.

<img src="https://mintcdn.com/docket-dcd24ade/Kks4baIOAtT7fIac/images/Screenshot_2025-07-27_at_4.16.56_PM.png?fit=max&auto=format&n=Kks4baIOAtT7fIac&q=85&s=437995580e7ec3ba65b981ebbec0857a" alt="Screenshot 2025-07-17 at 3.59.28 PM.png" width="782" height="852" data-path="images/Screenshot_2025-07-27_at_4.16.56_PM.png" />

You can then assign this account as the login module for any test suite:

<img src="https://mintcdn.com/docket-dcd24ade/Kks4baIOAtT7fIac/images/Screenshot2025-07-17at3.59.56PM.png?fit=max&auto=format&n=Kks4baIOAtT7fIac&q=85&s=9d9ba61a66d7821c85cdc7fb663c2355" alt="Screenshot 2025-07-17 at 3.59.56 PM.png" width="1008" height="790" data-path="images/Screenshot2025-07-17at3.59.56PM.png" />

### Region

Select the geographical region where your tests will execute. Choose a region close to your servers for best performance and lower network latency.

### Notifications

Configure email, Slack, or webhook [notifications](/essentials/notifications) for test results.

### Variables

Define key-value pairs at the suite level and reference them in test steps using `@variable_name` syntax.

Mark random or email variables as **fixed** to share the same generated value across all tests in a suite run.

### Agent Rules

Add suite-level [agent rules](/essentials/agent-context) that apply to all tests in the suite. These are combined with your company-wide rules.

### Scheduling a Test Suite

You can also schedule all tests in a given test suite to run at regular intervals. See the [scheduling section](/essentials/running-test#scheduling-a-run) in the Running a Test guide for instructions on how to set this up.

**Related Pages:**

* [Creating a Test](/essentials/test-creation) - Learn how to add tests to your suite
* [Running a Test](/essentials/running-test) - Different ways to execute your tests
