As your testing requirements change, you can update your tests from the test details page. Click on Edit test to open the editing options for your test. The options available depend on the test type:
- Browser tests - Edit with mabl, Open Trainer, Quick edit, or Edit configuration
- Mobile tests - Open Trainer, Quick edit, or Edit configuration
- API tests - Edit test opens the API test editor
- Performance tests - Edit test opens the performance test form
The Edit test menu on the test details page
However you edit a test, mabl saves your changes as a new version. You can also keep changes on a branch for review before merging them into your default branch. See Save and review your changes.
Ways to edit test steps
Hand off editing to the mabl agent
Instead of editing steps yourself, you can describe what you want to change and let the mabl agent do the work. Click Edit test > Edit with mabl and describe your change in plain language. The agent applies the edit, replays the test to confirm it still passes, and saves the result to a branch for review.
For more information on editing with the mabl agent, see edit an existing test with the mabl agent.
Editing with the mabl agent is only supported for browser tests.
Edit in the mabl Trainer
Click Edit test > Open Trainer to launch your web or mobile application in the mabl Trainer and edit step by step. Use this option when you want to interact with your app and play back your updates as you make them.
When you open the Trainer, you can adjust the settings for your training session in the training configuration modal:
- Application
- Environment
- URL override
- Credentials
- DataTable scenario
The training configuration modal
By default, the modal selects the values associated with the test, but you can change them as needed.
Quick edit
If your changes don't require interacting with the web or mobile application under test, you can use quick edit: Edit test > Quick edit. See quick edit mode for details.
Edit an API test
For API tests, click Edit test to open the API test editor, where you can edit requests, assertions, and other API test settings.
Edit a performance test
For performance tests, click Edit test to open the performance test form, where you can update the test's configuration. See creating performance tests for more details on the fields in this form.
Edit the test metadata
To update a test's metadata, such as name, description, and labels, click on the pencil icon in the top left corner.
Test information can include:
- Test name and description
- Test labels
- DataTable settings
- Variable sharing
- Associated Xray test cases or test case IDs for a custom integration
You can also update test metadata through the mabl API or the mabl MCP.
Save and review your changes
When you save your updates, mabl creates a new version of the test. To view all saved versions or revert to a previous one, open the CHANGE HISTORY tab on the test details page.
To make edits without affecting the master version of the test, save your changes on a branch. Edits made by the mabl agent are saved to a branch by default so you can review them before merging.
Note
You cannot edit test steps for the following auto-generated mabl tests:
- Visit home page
- Visit all linked pages within the app (also known as the Link Crawler)
- Visual tests