Editing journeys

If your Journey is failing because a step doesn't work as intended or runs into an issue, mabl lets you edit your Journey's steps while keeping only the important info: the URL, environment, application, etc.

You can edit your journeys by launching the mabl trainer or within the app itself.

How to edit your Journeys

It only takes a few steps to edit your Journeys:

  1. Make sure you're on the journeys page, and that you've trained at least one Journey in the past. Note: You cannot edit the two automated tests that mabl creates and runs for each app.
  2. Notice the checkbox next to each journey. Click on the one(s) you would like to edit.
  1. Click on the "Edit steps" button at the top of the screen.
  1. You will be directed to the beginning of the Journey. Simply continue as you normally would through the Journey. If you want to cancel any changes, simple click the "Cancel" button at the bottom of the trainer. Your changes will only be saved if you click the "Save" button.

Did you know?

You can open the mabl trainer in Chrome DevTools to more easily view your steps and important information for easier editing.

Quick Edit: Editing your journeys in the mabl app

Selecting "Quick Edit" mode when editing a journey pops the trainer into the mabl app itself, allowing you to edit most steps. You can edit almost everything, as long as it does not require interaction with the app under test. Because of this, creating new steps such as assertions and clicks, as well as replay, are not available in quick edit mode. Among the allowed features are: deleting steps, editing assertions, add waits, reordering steps, creating flows, and more.

Saving your edited journeys

You can save your edited journeys as many times as you'd like, as long as you've altered, added, or removed at least one step since you opened the journey. When you save, the trainer will display a confirmation message. You can continue training as normal after your save. Just click the "cancel" button to return to the app.

The confirmation message after clicking save. Also, note that the "Save" button is grayed out as know changes have been made since the previous save.

The confirmation message after clicking save. Also, note that the "Save" button is grayed out as know changes have been made since the previous save.

Even if you accidentally click cancel when you've edited your journey, mabl will prompt you with a modal asking if you'd like to save. You can discard the changes since the last save and return to the app, save the new changes and return to the app, or cancel and return back to the trainer.

Important information about editing journeys

mabl does not place limits on how many users can edit a journey at one time. Thus, it's important to coordinate with your team members to be sure new changes aren't saved over by another user. If you believe this has taken place, please contact mabl support in-app or at support@mabl.com so we can resolve this issue for you.

Drag-and-drop editing

When you're using the trainer, you can drag-and-drop your steps to reorder them in any way you'd like. This is great if you don't want to have to step all the way through your journey to add a simple wait step, Javascript step, or similar.

Use caution when dragging and dropping steps to reorder them. Make sure you're on the correct page when recording steps. Adding steps to the journey from the wrong page can cause the mabl trainer to fail.

Editing steps using arrow keys

You can easily step through parts of your trained tests using the arrow keys, as long as the trainer is "in focus." When the trainer is in focus, it will display "edit" in the upper righthand side of the trainer.

Simply press the arrow keys up or down to move the magenta status bar throughout the trainer journey. Be careful about adding steps in the wrong place, since clicks, entered text, and similar will still be recorded while you're stepping through your journeys as long as you are not in replay mode.

By using the arrow keys to step through your journey, you can add steps just about anywhere. You must be aware of when and where you are adding steps, as adding steps to the journey from the wrong page can cause mabl to fail later on. Always be sure to be on the correct page when recording new steps.

Editing steps with replay

Since mabl allows you to replay each step of your journey with the trainer, it is also used to step through which part of the journey you would like to add your new step to.

Please see the gif below to understand how to properly edit and insert a step using replay.

Steps without edit support

There is currently one step that you cannot currently edit, due to limitations:

  • Changing assertions on properties or Variables

Editing journeys

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.