Skip to main content

Linking Your Domain

This guide walks you through connecting your custom domain to your Urumi store.

Prerequisites​

Before you start, ensure you have:

  • Access to your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.)
  • Permission to modify DNS records
  • Your domain is not currently in use by another service

Step 1: Start the Connection Process​

  1. Go to your store's Settings > Domains
  2. Enter your domain name in the input field (e.g., www.yourstore.com)
  3. Click Connect Domain
Replacing Existing Domain

If you already have a custom domain connected, linking a new domain will replace it.

Step 2: Add DNS Validation Records​

After clicking Connect Domain, you'll see one or more DNS records to add:

For each record displayed:

  1. Copy the Name value
  2. Copy the Value value
  3. Log in to your domain registrar
  4. Add the record with the exact values shown

Example DNS Record​

FieldValue
TypeCNAME (or as specified)
Name_acme-challenge.www
Valueabc123.validation.urumi.ai
Exact Values Required

Copy the values exactly as shown. Even small differences can cause validation to fail.

Step 3: Wait for Validation​

After adding the DNS records:

  • The page shows a "Validating..." indicator
  • Urumi automatically checks for the records
  • Validation typically takes 5-30 minutes
  • In some cases, it can take up to 24 hours

You can leave the page and come back - the process continues in the background.

Step 4: Add Final CNAME Record​

Once validation succeeds, you'll see the final step:

  1. A success message confirms DNS validation
  2. You're shown one final CNAME record to add
  3. Add this record to your domain registrar

Final CNAME Record​

FieldValue
TypeCNAME
NameYour domain (e.g., www or shop)
ValueYour Production URL

Step 5: Activate Domain​

After adding the final CNAME:

  1. Click the Activate Domain button
  2. Wait for the activation to complete
  3. Your domain is now connected!

Your custom domain will now serve your Production environment.

Canceling the Process​

At any point before activation, you can click Cancel Process to:

  • Stop the domain connection
  • Remove any pending validation
  • Start over with a different domain