Test Plans

A test plan is a named, runnable collection of test cases inside a project. Curate the cases you care about once, then dispatch the whole plan as a launch whenever you need to run it.

The Test plans page

Open Test Plans from the sidebar (/app/test-plans). It's a master-detail view: the list of plans on the left, the selected plan on the right, and + New plan to create one.

Composition methods

You choose how a plan is populated when you create it — and the method is fixed afterwards:

• Manual — you add and remove cases by hand.
• Filter — the plan's cases are derived from a saved filter. Re-run the filter any time from the plan to pull in newly-matching cases; if the linked filter is deleted you can repair or unlink it.

Anatomy of a plan

• Cases — the test cases in the plan.
• Executors — who runs each case: manual executors (people) and automated executors (a CI Job), assigned per case.
• Default job — the CI Job used to dispatch the plan's automated cases.
• Launch name pattern — a template for the launch name, with {plan}, {date}, and {user} placeholders.
• Environment and environment variables, Tags, and issue / resource links — preset attributes carried onto every launch the plan creates.
• Tree — an optional attribute tree used to group the case preview.

The four tabs

• Overview — plan summary; for a Filter plan, the saved-filter link with Sync / Unlink.
• Cases — add, remove, and review the plan's cases.
• Executors — assign manual (people) and automated (Jobs) executors per case.
• Settings — default job, launch-name pattern, environment, and tree.

Running a plan

Run launch opens a dialog pre-filled with the plan's preset attributes — launch name, environment, tags, environment variables, issue links, and resource links — each overridable for this run. Submitting creates a Launch linked back to the plan; automated cases dispatch the default job's CI workflow. A plan with automated cases but no default job blocks the run until you set one.

For a step-by-step walkthrough, see Working with test plans.