> For the complete documentation index, see [llms.txt](https://bugowl.gitbook.io/bugowl-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bugowl.gitbook.io/bugowl-ai/core-concepts/test-data.md).

# Test Data

Test Data stores variables and datasets that can be used across your test cases. It allows you to define different values for different environments while keeping your tests organized and maintainable.

#### What is Test Data?

Test Data contains:

* **Title**: Descriptive name for the dataset
* **Key-Value Pairs**: Variables with their corresponding values
* **Environment-Specific Data**: Different values for different environments
* **Project Association**: Linked to a specific project

#### Creating Test Data

1. Go to "Test Data" → "Add New Data"
2. Select your project
3. Enter a descriptive title (max 50 characters)
4. Choose environments where this data will be used
5. Add key-value pairs for each environment
6. Click "Create Test Data"

#### Key-Value Structure

* **Keys**: Must be alphanumeric or underscore only (e.g., `username`, `api_key`, `base_url`)
* **Values**: Can contain any text or data
* **Environment-Specific**: Each environment can have different values for the same key

#### Environment Integration

* Test data is scoped to specific environments
* You can select multiple environments for the same dataset
* Each environment can have different values for the same variables
* Color-coded environment indicators help identify data sources

#### Managing Test Data

* **View**: See all test data in a table with JSON tree display
* **Edit**: Modify title, environments, and key-value pairs
* **Delete**: Remove unused test data (only if not referenced elsewhere)
* **Sort**: Sort by title, creation date, or update date

#### Best Practices

* Use descriptive titles (e.g., "User Credentials", "API Endpoints")
* Keep keys simple and consistent across environments
* Group related variables together in the same test data set
* Use environment-specific values when needed (dev vs prod URLs)

#### Getting Started

1. Navigate to "Test Data" in the sidebar
2. Select your project from the tabs
3. Click "Add New Data"
4. Fill in the required information
5. Add key-value pairs for your selected environments

Test Data provides a centralized way to manage variables and datasets across your testing environments, making your tests more maintainable and flexible.


---

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://bugowl.gitbook.io/bugowl-ai/core-concepts/test-data.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.