Using labels

Using labels to manage flows, tests, and plans in your workspace

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

Searching a workspace by label

📘

Note

Label names are case sensitive.

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.
Plan labels

Adding labels to a plan

  1. 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

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.

Searching for flows by label in the mabl Trainer

Searching for flows by label in the mabl Trainer

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.

Editing flow info

  1. In the Update Flow Information modal, create or select the label to add.
  2. 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.

📘

Limitations on bulk actions

Only test labels can be added in bulk. Plan labels and flow labels cannot be added in bulk.

Bulk actions are not supported for updating and removing labels.

If you have a use case requiring bulk actions with labels, please let us know in our feedback portal.