> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/test-steps/utility/tag-test.md).

# Tag Test

Tag Test labels the current [Flow Branch](/getting-started/terminology.md) with a tag. Use it so Run Recipes, Schedules, and CI/CD filters can include smoke tests, skip slow paths, or group journeys without editing every Run by hand.

![Tag test Test Step](https://app.does.qa/screenshots/node/utility_tag_test.png)

## When to use it

* Mark smoke, regression, or environment-specific branches.
* Set **Manual Run Mode** to **Ignore Test Case** when a branch should run in CI or Schedules but not when someone starts a Run from the Flow Builder.
* Place Tag Test early on the branch so the label is obvious when you read the Flow.

See [Choose Flow Branch shapes](/better-coverage/choose-flow-branch-shapes.md) for the join and split patterns, then [Build smoke and regression coverage](/better-coverage/build-smoke-and-regression-coverage.md) and [Run across environments](/better-coverage/run-across-environments.md).

## Configure

### Basics

| Field               | What to set                                                                                                                                          |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tag**             | The tag to apply to this Flow Branch                                                                                                                 |
| **Manual Run Mode** | `Run Test Case` (default) keeps the branch for manual Runs. `Ignore Test Case` skips it on manual Starts while filters can still select it elsewhere |

### Advanced

| Field              | What to set                                          |
| ------------------ | ---------------------------------------------------- |
| **Status on fail** | [Failed Status](/test-step-options/failed-status.md) |

{% hint style="info" %}
**Pro tip:** Keep tag names short and consistent (`smoke`, `staging`, `checkout`) so Recipes and CI `withAll` filters stay easy to read.
{% endhint %}

## Related

* [Choose Flow Branch shapes](/better-coverage/choose-flow-branch-shapes.md)
* [Build smoke and regression coverage](/better-coverage/build-smoke-and-regression-coverage.md)
* [Run Recipes](/configuration/run-recipes.md)
* [CI / CD](/configuration/ci-cd.md)
* [Utilities](/test-steps/utility.md)

**Tags:** `utility`, `tag`, `test`, `branch`