Migrating to the Unified test runner

By default, all new test and plan runs are configured to use the Unified Runner for Chrome. However, your team may have existing plans that were originally created with the Legacy Runner.

🚧

Legacy Runner sunset

The Unified Runner replaces the Legacy Runner:

• Safari Legacy will be formally retired on July 3, 2023.
• Firefox Legacy will be formally retired on October 2, 2023.

Visit the Legacy Runner sunset plan for more details.

Migrating to the Unified Runner

For a limited period of time, existing accounts can run tests against Firefox and Safari on both Legacy and Unified Runners:

• Existing accounts created before February 15, 2023 can run tests on Firefox Unified or Firefox Legacy.
• Existing accounts created before May 15, 2023 can run tests on Safari (WebKit) or Safari Legacy.

You can migrate Legacy plans to the Unified Runner in bulk or edit plan settings for an individual plan.

Bulk migration

To migrate plans in bulk from Legacy to Unified, take the following steps:

1. Click on Plans in the left-hand navigation.
2. Select the appropriate Legacy runner browser in the browser filter: "Firefox [Legacy]" or "Safari."

1. Click on the checkbox next to the Plan name column to select all plans.

4. Click on the Edit button.
5. In the Bulk Edit modal, select the appropriate option to migrate tests to the Unified Runner:
   1. For Firefox, select "Migrate Firefox test runs to the Unified runner"
   2. For Safari, select "Migrate Safari test runs to Safari (WebKit) unified runner"

6. Click on the Next button to review the changes.
7. Click on the Migrate button to confirm the changes.

This process updates the selected plans from the Legacy Runner to the Unified Runner. If needed, you may revert from Unified to Legacy using the same process in the Bulk Edit modal.

Editing individual plans

To move individual plans from Firefox Legacy to Firefox Unified, take the following steps:

1. Click on Plans in the left-hand navigation.
2. Select the plan that you want to update.
3. On the Plan Details page, click on the pencil icon to edit the plan's settings.
4. In the Device Settings section, make sure the "Use Legacy Runner" checkbox below Firefox or Safari (WebKit) is not selected.

5. Click Save plan to confirm your change.