Managing tests

As your test automation strategy evolves, you may need to make changes to your existing set of mabl tests. This article shows you how to manage tests in the mabl app, including how to…

• Change a test's name
• Add test labels
• Disable a test
• Restore a test to a previous version
• Compare different versions of a test
• Delete a test

How to change a test's name

On the test details page for the test that you want to update, take the following steps:

1. Click on the pencil icon to open the update test information modal.
2. Update the Name field to the new test name.
3. Click Save.

Updating the test name

How to add test labels

Test labels are useful for defining groups of tests in the mabl app and the mabl CLI.

To add labels to a single test:

1. Go to the test details page
2. Click on the pencil icon.
3. In the update test information modal, select from an existing label or create a new label.
4. Click Save to add the new label(s).

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.

Adding test labels in bulk

How to disable a test

If a test has an error that requires further investigation, you can disable or "pause" the test to prevent it from running in plans, scheduled executions, or deployment events.

To disable a test, set the On/Off toggle to Off on the test details page.

Disabling a test

While you can still run a disabled test ad hoc, the disabled test will not be included in any plan runs.

How to restore a test to a previous version

To revert a test to a previous version, click on the History tab in the test details page. Use the  version dropdown to view different test versions and the user who saved each test version.

When you identify the version you want to use, click on Save as latest to revert to the previous version.

Reviewing test versions

How to compare different versions of a test

If you are troubleshooting a test failure or just want to see how a test has changed over time, click on the Compare tab to access a full line-by-line diffing view of the changes between two versions of the same test.

Select the versions you want to compare from the Base version and Current version dropdowns.

Comparing different versions of the same test

Click directly into steps to view more details about that step, such as target element details.

How to delete a test

To delete a single test, click on the trash icon on the test details page.

Deleting a test

You can also delete tests in bulk from the tests page:

1. Click on the checkbox for each test you want to delete. 
2. Click on the Delete button.
3. In the confirmation modal, click Delete again.

When you delete a test that contains reusable resources, such as flows, snippets, DataTables, or file uploads, those resources will still remain in your workspace after the test is deleted.