What a journey contains
A repository’s library holds up to 50 journeys.
Create journeys
You can create journeys in three ways:- Map with an Agent: on an empty library, select Map with an Agent. An agent inspects the repository, without running its code or changing it, and proposes journeys for the branch. Open its conversation with View Agent, review the proposal, and tell the agent which journeys to add.
- Add user journey: select Add user journey and fill in the drawer. Title, User / role, Goal, and at least one step are required. Select Add to library to save it.
- Duplicate journey: in a journey’s row actions, select Duplicate journey to start from a copy.
Edit journeys
Open a journey and select Edit, or select Edit journey in its row actions. Change it, and select Save user journey. When an edit changes more than one thing, the Review journey changes dialog summarizes the changes before you save. Each save creates a new revision of the journey. Results from earlier runs keep the definition they ran with, and a result from an older revision is marked Outdated. To delete a journey, select Manage journey > Delete user journey, or select several journeys and choose Delete selected. Deleting a journey also deletes its linked bugs and blockers. Its execution history remains available.Run journeys on demand
1
Open the run dialog
On the repository’s User journeys page, select Run tests on the toolbar. It appears while no journeys are selected. To run specific journeys, select them and choose Run selected, or open a journey and select Run. The Run verifier dialog opens.
2
Choose the branch
In Run branch, choose the branch to test. The environment comes from the repository’s settings; change it there if you need another one.
3
Choose the journeys
Select Tags to run only the journeys that have all the selected tags, or pick journeys under Choose journeys for this run. Include all and Clear all select or clear the list. If you filtered the journey table, Run scope chooses between Filtered journeys and All active journeys. A run can include up to 50 journeys.
4
Start the run
Select the Run button, which shows how many journeys will run.
Schedule runs
A schedule runs a set of journeys on a branch regularly. On the repository’s page, select Journey Testing > Schedules, then select Create schedule (or Create first schedule if there are none yet).
How schedules behave:
- A scheduled run runs as the person who created the schedule. Their access is checked again at each occurrence.
- Each occurrence tests the head of the branch when it starts. The journey’s run history shows the commit it tested.
- If another Verify run is active on the same branch and environment, that occurrence is skipped, not queued.
- Use a schedule’s row actions to Edit, Pause or Resume, or Delete it. Pausing and deleting stop future occurrences; runs already accepted can finish.
- Scheduled runs appear in the repository’s run history like on-demand runs.
- Verify doesn’t notify anyone when a scheduled run fails, is blocked, or is skipped. Check the schedule’s Occurrence history, or turn on Auto create issues to get Jira or Linear issues for new bugs, or for new bugs and blockers with Bugs & blockers. An issue is created only for a finding first seen in that run. Failed and skipped occurrences don’t create issues.
Occurrence history
Select Occurrence history in a schedule’s row actions to see each occurrence and why one was skipped or failed:- “No journeys matched the saved tags.”
- “A selected journey or repository is unavailable.”
- “Another Verify run was active on this branch and environment.”
- “The saved environment is unavailable or needs preparation.”
- “The saved branch is unavailable.”
- “The schedule creator no longer has the required access.”
- “Verify execution could not pass the billing checks.”
- “The journey library or execution configuration changed before admission.”
What’s next
Results and bugs
Read outcomes and evidence, and turn bugs into tickets or coding tasks.
Set up Verify
Change a repository’s branch, environment, and test instructions.
Troubleshooting
Fix runs that don’t start or end without a result.