Using labels

As your workspace grows, labels help keep your plans, tests, and flows organized. This guide outlines plan labels, test labels, and flow labels and how to manage them.

Searching a workspace by label

Plan labels

Plan labels are useful for defining test suites, such as "regression", "targeted regression", "smoke", or a certain functionality or feature area. You can use plan labels to run a set of plans in tandem as a mabl deployment event.

Managing plan labels

To add a label to a plan:

1. Open the plan in the plan details page.
2. Click on the edit pencil.
3. Create or select the label to add.

4. Click Save.

To remove a label from a plan:

1. Open the plan in the plan details page.
2. Click on the edit pencil.
3. Remove the label.
4. Click Save.

Test labels

You can use test labels to define a group of tests for the following purposes:

• Running tests ad hoc from the mabl CLI: both ad hoc run commands - mabl tests run and mabl tests run-cloud have--labelsand--exclude-labels options
• Filter tests by label and add to a certain plan.

Filtering tests by label and adding to a plan

Managing test labels

To add a test label to a single test, open the test in the test details page and click on the edit pencil. In the update test information modal, add a new or existing test label and click Save.

To add test labels to a group of tests in bulk, click on Tests in the left-hand navigation and take the following steps:

1. Check the box next to each test that you want to add the label to.
2. Click on the Add labels button.
3. Create or select the label to add.
4. Click on the Add labels button to confirm your changes.

To remove a label from a test:

1. Open the test in the test details page.
2. Click on the edit pencil to open the update test information modal.
3. Remove the label.
4. Click Save.

Flow labels

You can use flow labels in the mabl Trainer to search for a specific group of flows using the syntax "label:<label name>" For example, if you want to find flows with the label "login", you can type "label:login" in the search input.

Managing flow labels

To add a label to a flow:

1. Open the flow in the flow details page.
2. Click on the edit pencil to update flow information.

3. In the update flow information modal, create or select the label to add.
4. Click Save.

To remove a label from a flow:

1. Open the flow in the flow details page.
2. Click on the edit pencil to update flow information.
3. In the update flow information modal, remove the label.
4. Click Save.