Creating a rollout

You can create a new rollout from the Markets > Rollouts page of your Shopify admin, and then add changes and details to your rollout.

To create a rollout, follow these steps:

  1. Create the rollout.
  2. Add one or more changes to the rollout.
  3. Configure the details of the rollout.

Before you start

Depending on the type of change that you want to add to your rollout, you need to make some changes to the relevant area of your Shopify admin before you create the rollout. Review the following considerations for adding a change to a rollout:

  • If you want to edit your main theme, then you need to save the rollout before you can make edits to your main theme.
    • You can only edit your main theme. Make sure your main theme is the theme that you want to edit.
  • If you want to replace your main theme, then you need to add that theme to your online store first. You can still edit the replacement theme after you add it to the rollout.
  • If you want to replace your checkout and accounts configuration, then you'll need to create the configuration first. You can still edit the replacement configuration after you add it to the rollout.
  • If you want to add a catalog change, then you need to create the catalog first. You select an existing catalog when you add the change, and then choose whether the rollout sets that catalog to active or to draft. You can add only catalogs that you create for markets, and the catalog doesn't need to be assigned to a market yet. B2B catalogs that you create for a company location can't be added, and archived catalogs can't either. Neither is displayed when you select a catalog.
  • If you want to activate or deactivate discounts, then you need existing discounts. A discount can be part of only one unended rollout at a time.

Step 1: Create the rollout

First, create and name your rollout, and then select the type of rollout that you want to create or adjust the settings.

Selecting a rollout type sets the defaults for the rollout's dates, audience, and what happens to the changes when the rollout ends. You can still adjust any settings after selecting a type, and adjusting settings can also change the rollout's type. For example, if you select Launch as the rollout type and add an end date, then the rollout type changes to an Event. This is because a Launch rollout applies the changes permanently instead of rolling them back after a scheduled period. Learn more about the different types of rollouts.

Depending on the changes that you want to add, you might need to save your rollout before you can add changes.

  1. From your Shopify admin, go to Markets > Rollouts.

  2. Click Create rollout.

  3. In the Name section, add a name for the new rollout, such as Summer Sale 2026.

  4. In the rollout type menu, select Launch, Event, or Experiment.

Step 2: Add changes to the rollout

You can add the following types of changes to a rollout:

You can add only one theme change and one checkout and accounts change to each rollout. Learn more about the types of changes in a rollout.

If you want to replace your main theme, then you can also update the replacement theme's content using a compatible translation app, such as the Translate & Adapt app.

Steps:

  1. In the Changes section of your rollout, click Add changes.
  2. Optional: If you want to edit your main theme, then click Save to save your rollout.
  3. In the Add changes dialog, select the category of change that you want to add:
    • For Online store changes, select either of the following options:
      • In the Prepare changes to your current theme section, click Edit theme, customize your theme in the theme editor, and then click Save.
      • In the Replace the current theme section, select a new theme.
    • For Checkout & accounts changes, in the Replace the current configuration section, select a configuration.
    • For Catalogs changes, search for and select each catalog that you want to change, and then click Set to active or Set to draft for that catalog. Each catalog that you select is set to active until you change it, so select Set to draft for any catalog that you want to withdraw.
    • For Discounts changes, select each discount that you want to change, and then set whether that discount is activated or deactivated for the customers in your rollout.
  4. Click Apply.
  5. Optional: To add another type of change, click Add changes.

Step 3: Configure the rollout details

After you add changes to your rollout, you can configure the details for your rollout, such as the audience and the start and end dates of the rollout.

Set the traffic allocation

In the Audience section, the Traffic allocation setting controls the percentage of eligible visitors that the rollout applies to. This percentage applies to all changes in your rollout. If the rollout applies to less than 100% of visitors, then you must also select a start date and an end date.

The Eligibility setting displays the markets that the rollout applies to. The markets are determined by the changes that you added to the rollout, so you can't select them. A theme replacement always applies to all markets.

You can't target a rollout to a customer segment, a customer tag, or a device. Visitors are put in groups at random. Learn more about how visitors are assigned.

If the rollout reaches less than 100% of your customers, then your ads, listings, and product feeds might not match what some customers are shown on your online store. Learn more about rollout reach and external channels.

Steps:

  1. In your rollout, go to the Audience section.
  2. In the Traffic allocation section, click All eligible visitors, and then adjust the slider, or enter a percentage.

Set the start date and time

You can schedule the rollout to start and end at a future date and time. The timezone is set to your store's timezone in Settings > General.

The label for the date fields matches the rollout type that you selected: Changes publish for a Launch, Event runs from for an Event, and Experiment runs from for an Experiment.

Publishing a new theme can affect your rollouts. Learn more about publishing a new theme.

Steps:

  1. In the Scheduling section, click Start date.
  2. Select or enter a date and time.
  3. Click Done.

Set the end date and time

If you want a rollout to only apply for a scheduled period of time and then roll back, then you can set an end date and time for the rollout. You must set an end date for the either following Audience configurations:

  • You assign the Traffic split to less than 100% treatment.
  • You set the Traffic allocation to less than 100%.

The rollout displays a description of what happens when it ends, so that you can confirm the behavior before you save. You can change the rollout type to Launch to remove the end date and apply the changes permanently instead.

If the rollout has the Draft or Scheduled status, then you can edit the rollout's configuration details and change this action. If the rollout is active, and you want to end it before its scheduled time, then you can manually end the rollout instead.

Steps:

  1. Click Set end date.
  2. Select or enter a date and time.
  3. Click Done.

Set the traffic split for an Experiment

If you select Experiment as the rollout type, then the Audience section displays a Traffic split between the control and the treatment. By default, a new Experiment uses a traffic split of 50% control and 50% treatment, and an end date 90 days after the Experiment starts. Learn more about the different types of rollouts.

Steps:

  1. In the Audience section, click the Traffic split percentage.
  2. Select one of the preset options, or use the slider to adjust the split between the control and the treatment.

Review conflicts before you save

While you configure a rollout, the rollout is checked against the other rollouts on your store, and any conflicts are displayed before you save. Review the following types of messages:

  • Resolve rollout conflicts: You need to fix the issue before you can save the rollout.
  • Review rollout conflicts: You can save the rollout, and the message describes how another rollout affects your changes.

Overlapping active rollouts can affect traffic allocation and which changes are available to visitors. The effect of the overlap depends on the changes in each rollout and their traffic settings. Make sure you review and resolve conflict messages before you save your rollout. Learn more about managing multiple active rollouts.

Editing your main theme in the theme editor

Any customizations that you make in the theme editor apply to only that rollout. Areas of your theme that aren't customized in a rollout automatically stay synchronized with customizations made to your published theme. If you have multiple rollouts, or want to make edits to your published theme, then you can select a different option from the rollouts menu in the theme editor's menu bar.

If you have more than one market, then you can select specific markets to apply the changes to. Learn more about creating and managing markets and customizing your theme for specific markets.

Publishing a new theme can remove these customizations. Learn more about publishing a new theme. Review the requirements and considerations for using rollouts before you edit your main theme.

Learn more about using the theme editor to customize your theme.

Steps:

  1. From your Shopify admin, go to Online Store.

  2. Next to your main theme, click Rollouts.

  3. Click the name of the rollout that you want to customize, or search for a rollout.

  4. In the theme editor, customize your theme.

  5. Click Save.

Editing theme content

If you add a theme replacement change to your rollout, then you can also update the replacement theme's content and translations using a compatible translation app, such as the Translate & Adapt app.

You can't update your replacement theme's languages and translations for a rollout using any of the following methods:

  • Adding manual translations.
  • Uploading translations with a CSV.
  • Using an incompatible translation app. Compatible apps must use Shopify's Admin API. If you aren't sure whether your translation app is compatible, then contact the app's developers to confirm whether the app uses the correct API.
  • Editing default theme content from the theme editor by clicking Horizontal menu > Edit default theme content.

Learn more about requirements for localizing and translating content on your online store.

Steps:

  1. From your Shopify admin, go to Apps > Translate & Adapt.

  2. Select any category in the Theme section.

  3. Click the theme selector.

  4. In the Rollouts section, click the theme that you want to edit.

  5. Make any adjustments to the theme content for any language.

  6. Click Save.