Skip to content

Instantly share code, notes, and snippets.

@benjaminsehl
Last active June 6, 2023 15:08
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save benjaminsehl/74b59189a4409b8e2fb4605b2d8d3e6a to your computer and use it in GitHub Desktop.
Save benjaminsehl/74b59189a4409b8e2fb4605b2d8d3e6a to your computer and use it in GitHub Desktop.

Launching Your Hydrogen Storefront

This guide will walk you through the process of launching your Hydrogen storefront on Shopify. Follow these steps to ensure a smooth transition and a successful launch.

Update your Notifications domain

Ensure that the domain associated with your transactional emails and notifications, found in /admin/settings/notifications, correctly points to the associated domain of your Hydrogen storefront. This ensures that customers receive accurate information in their email notifications.

Add Preferred Vanity Domain

Add your preferred vanity domain inside of /admin/settings/domains by following the instructions on that page. This will ensure that your Hydrogen storefront is accessible through your desired domain.

Configure Checkout URL

Configure the checkout URL (primary domain for Online Store) in /admin/settings/domains. It should be the same hostname as your Hydrogen storefront (e.g., www.brand.com). We suggest using the subdomain checkout (e.g., checkout.brand.com). Cookies should be stored on the apex domain (e.g., brand.com).

Manage Shopify Scripts

If you are using Shopify Scripts, you may need to unpublish and republish any Shopify Scripts and ensure they're available to the Storefront API. This ensures that your custom scripts continue to work with your Hydrogen storefront.

Set Up Redirects

If you no longer plan on using the Online Store for anything, set up redirects in theme.liquid. You can refer to this theme for what to add, or just download it and use it: https://github.com/shopify/hydrogen-redirect-theme, or by following the docs here: https://shopify.dev/docs/custom-storefronts/oxygen/migrate/redirect-traffic.

Launch Incrementally

If you plan on launching your Hydrogen site incrementally, meaning moving over pages to Hydrogen as you go while continuing to use your Liquid Online Store for some pages, please refer to the guide here: https://shopify.dev/docs/custom-storefronts/oxygen/migrate/incremental.

Update Facebook & Google Product Feeds

If you are using Facebook & Google apps for your product feeds for advertising, you'll need to update those catalogs to match the new domain. This can be done by either using a third-party tool instead of the standard Facebook and Google sales channels, or by setting up feed rules (Facebook here: https://www.facebook.com/business/help/1206652516201625?id=725943027795860 — Google here: https://support.google.com/merchants/answer/7450276?hl=en).

Publish Your Hydrogen Storefront

Publish your Hydrogen storefront by changing your preferred vanity domain to point to it in the /admin/settings/domains page. This will make your Hydrogen storefront live and accessible to customers.

By following these steps, you can successfully launch your Hydrogen storefront and provide a seamless experience for your customers.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment