​

Custom Domain Setup

After deploying your Weaverse Hydrogen storefront to Shopify Oxygen, you’ll want to connect your own domain (e.g., yourstore.com) so customers visit your brand URL instead of the default Oxygen subdomain. This guide covers the full process — from adding the domain in Shopify to configuring DNS records at your registrar — with provider-specific instructions for the most common setups.

​

Overview

Connecting a custom domain involves three steps:

1. Add the domain in Shopify Admin
2. Point it to Hydrogen (not the default Online Store)
3. Configure DNS records at your domain registrar / DNS provider

Shopify handles SSL certificate provisioning automatically once DNS is correctly pointed.

​

Prerequisites

• A deployed Hydrogen storefront on Shopify Oxygen (deployment guide)
• Access to your domain’s DNS settings (Cloudflare, Namecheap, GoDaddy, etc.)
• The domain must not be actively serving another site on the root (or you’ll need to plan the cutover)

​

Step 1 — Add Domain in Shopify Admin

1. Go to Shopify Admin → Settings → Domains
2. Click Connect existing domain
3. Enter your domain (e.g., yourstore.com) and click Next
4. Shopify will show you the required DNS records — keep this page open for reference

​

Step 2 — Point Domain to Hydrogen

By default, Shopify connects new domains to the Online Store sales channel. Since you’re running a Hydrogen storefront, you need to change the target:

1. In Settings → Domains, find the domain you just added
2. Click on the domain name to open its settings
3. Change the target from Online Store to your Hydrogen storefront
4. Save the changes

​

Step 3 — Configure DNS Records

The DNS configuration depends on your provider. The core requirement is the same everywhere:

---

​

Cloudflare

Cloudflare is a popular choice for DNS management. Follow these steps carefully:

​

DNS Records

1. Log in to Cloudflare Dashboard
2. Select your domain zone
3. Go to DNS → Records
4. Add the following records:

Root domain: www subdomain:

​

Cloudflare-Specific Settings

After adding DNS records, verify these settings:

1. SSL/TLS → Set encryption mode to Full (not Full Strict, not Flexible)
2. SSL/TLS → Edge Certificates → Turn OFF “Always Use HTTPS” — let Shopify handle the HTTPS redirect
3. Speed → Optimization → Turn OFF Auto Minify (Shopify/Hydrogen already optimizes assets)
4. Rules → Remove any page rules that might interfere with Shopify’s routing

---

​

Namecheap

1. Log in to Namecheap
2. Go to Domain List → click Manage next to your domain
3. Go to the Advanced DNS tab
4. Add the following records:

Root domain: www subdomain:

---

​

GoDaddy

1. Log in to GoDaddy
2. Go to My Products → DNS next to your domain
3. Add or edit records:

Root domain: www subdomain:

---

​

Google Domains / Squarespace Domains

Google Domains was migrated to Squarespace Domains in 2024. The DNS management interface is the same.

1. Log in to Squarespace Domains
2. Select your domain → DNS → DNS Settings
3. Click Custom Records → Manage
4. Add the following records:

Root domain: www subdomain:

---

​

Amazon Route 53

1. Open the Route 53 Console
2. Go to Hosted zones → select your domain
3. Click Create record for each:

Root domain: www subdomain:

---

​

HostGator / cPanel

1. Log in to cPanel
2. Go to Zone Editor (under Domains)
3. Select your domain → Manage
4. Add or edit records:

Root domain: www subdomain:

---

​

Netlify DNS

1. Log in to Netlify
2. Go to Domains → select your domain → DNS Settings
3. Add records:

Root domain: www subdomain:

---

​

Vercel DNS

1. Log in to Vercel
2. Go to Settings → Domains → select your domain
3. Go to the DNS records tab and add:

Root domain: www subdomain:

---

​

Other DNS Providers

For any DNS provider not listed above, apply these rules:

• If your provider supports CNAME on root (@): Use CNAME @ → shops.myshopify.com
• If your provider does NOT support CNAME on root: Use A @ → 23.227.38.65
• For www: Always use CNAME www → shops.myshopify.com
• Proxy/CDN: Turn off any proxy or CDN layer so Shopify can provision SSL directly
• TTL: Set to the lowest available value for faster propagation

​

Step 4 — Verify & SSL Provisioning

1. Wait for DNS propagation (typically 5–30 minutes, can take up to 48 hours in rare cases)
2. Go back to Shopify Admin → Settings → Domains
3. Click Verify next to your domain
4. Shopify will automatically provision an SSL certificate once DNS is verified

You can check propagation status using:

• whatsmydns.net — enter your domain and check CNAME or A records
• Terminal: dig yourstore.com CNAME +short (should return shops.myshopify.com)

​

Troubleshooting

​

Domain shows Online Store instead of Hydrogen

You missed Step 2. Go to Settings → Domains, click your domain, and change the target to the Hydrogen storefront.

​

SSL certificate not provisioning

• Ensure no proxy/CDN is between the domain and Shopify (Cloudflare orange cloud must be OFF)
• Verify DNS records are correct: dig yourstore.com CNAME +short
• Check that “Always Use HTTPS” is disabled in Cloudflare (if applicable)
• Wait up to 24 hours — Shopify retries SSL provisioning periodically

​

ERR_TOO_MANY_REDIRECTS

This usually means Cloudflare’s SSL mode is set to Flexible instead of Full. Change it to Full in Cloudflare → SSL/TLS settings.

​

Domain not resolving

• Confirm DNS records are saved and published
• Check for conflicting records (e.g., old A records pointing elsewhere)
• Verify with dig yourstore.com +short or whatsmydns.net

​

www not redirecting to root (or vice versa)

Shopify handles www ↔ non-www redirects automatically once both records are configured. Ensure both @ and www records exist and point to Shopify.

​

Primary Domain

After verification, set your preferred domain as the primary domain in Shopify:

1. Go to Settings → Domains
2. Click on your verified domain
3. Click Set as primary

Shopify will automatically redirect all other connected domains (including the default .myshopify.com URL) to your primary domain.

​

Summary

​

Additional Resources

• Shopify Domains documentation
• Shopify Hydrogen deployment
• Cloudflare DNS documentation
• Deploy to Cloudflare Workers