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 was 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 created before February 15, 2023 can run tests against Firefox on both the Legacy and Unified Runners. 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 "Firefox [Legacy]" in the browser filter.
  3. Click on the checkbox next to the "Plan name" column to select all plans.

Selecting all plans

  1. Click on the Edit button.
  2. In the Bulk Edit modal, select "Migrate Firefox test runs to the Unified runner".

Bulk migration to Firefox Unified

  1. Click on the Next button to review the changes.
  2. 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 is not selected.
Updating browser settings for a plan

Updating browser settings for a plan

  1. Click Save plan to confirm your change.