Redirect traffic to the Hydrogen channel

• You've completed your Hydrogen build and your Hydrogen storefront is ready for launch.
• You've added a domain and subdomain to your domain settings.

This step describes how to set up a primary domain to receive traffic for the Hydrogen storefront while using a subdomain to receive traffic for the Shopify web checkout.

1. From the Shopify admin, click Settings > Domains.
2. For the Subdomain that you connected to Shopify, change the Target to Online Store.
3. Set the domain type to Primary.

1. From the Shopify admin, under Sales channels, click Hydrogen.
2. In the Hydrogen storefronts interface, select the storefront that you want to receive online store traffic.
3. Click … beside the production environment, and then click Edit environment.
4. Change the URL privacy to Public, and then click Save.

1. From the Shopify admin, click Settings > Domains.
2. For the domain that you want to receive online store traffic, change the Target to the production Hydrogen storefront.
3. Set the domain type to Primary.

1. From the Shopify admin, under Sales channels, click Online Store > Preferences.
2. In the Restrict store access section, deselect Restrict access to visitors with the password.
3. Click Save.

If your online store had active orders before you launched your Hydrogen storefront, and the Hydrogen storefront uses the same domain formerly used by the online store, then customers will receive 404 pages when they click on the old order status URLs that are routing to your Hydrogen storefront. To prevent this, ensure that you redirect those requests back to the online store.

To handle a Shopify order status URL on your Hydrogen storefront, create a route to handle the redirect:

After going live on a Hydrogen storefront, your online store remains active. Visitors can browse online store pages if they visit your {shop}.myshopify.com URL. If you want to serve your Hydrogen storefront to visitors who land on online store pages, then you should use a client-side redirect in theme.liquid.

If your custom storefront uses Cart and you want to enable bot protection, then customize your checkpoint.liquid template before you schedule the protection. This prevents your client-side redirect from going to a /checkpoint route on the custom storefront that doesn't exist and delivering a 404 response to customers.

After your scheduled bot protection has expired, you can keep this customization for future events such as flash sales.

The code following example assumes a checkout.shop.com pattern for the subdomain. Update your checkpoint.liquid template with the following code. You can change checkout to reflect your chosen subdomain.

• Learn how to adopt Hydrogen incrementally for merchants who want to use the online store theme and Hydrogen channel side-by-side.