Solutions for custom domain and DNS configuration.
Domain Stays on "Pending"
DNS not yet propagated
Normal: One to 24 hours (usually under 1 hour)
Solution:
-
Wait at least 1 hour
-
Click Refresh Status
-
Check DNS propagation with tool: whatsmydns.net
-
If >48h: Check DNS entries
DNS entries incorrect
Symptom: Status Error or stays Pending
Check:
-
CNAME Host:
www(notwww.your-domain.com) -
CNAME Value:
cname.vercel-dns.com(exact) -
A Record Host:
@(for root domain) -
TTL: 3600 or lower
Tools:
- nslookup:
nslookup www.your-domain.com - dig:
dig www.your-domain.com CNAME
Domain Shows Error
Domain verification failed
Cause: DNS entries not correct
Solution:
-
Log in to domain provider
-
Open DNS settings
-
Delete all entries and create new ones:
- Type: CNAME
- Host: www
- Value: cname.vercel-dns.com
- TTL: 3600
-
Save, wait 10 minutes
-
Refresh Status in Stayoa
Domain already in use
Cause: Domain on another property or service
Solution:
- Domain can only be used once
- Remove domain from other service
- Or use subdomain (e.g.,
booking.your-domain.com)
SSL/HTTPS
Connection not secure warning
Cause: SSL certificate not yet active
Solution:
-
DNS must be fully propagated
-
SSL activates automatically
-
Wait one to two hours after DNS propagation
-
Don't force HTTPS via DNS (handled automatically)
SSL certificate invalid
Solution:
-
Check domain status in Stayoa
-
Click Refresh Status
-
Certificates renew automatically
-
If problems persist: Re-add domain
Root Domain vs. Subdomain
Root domain doesn't work
Problem: Many providers don't support CNAME for root domain
Solution 1 (Recommended):
-
Use
www.your-domain.comin Stayoa -
Set up a 301 redirect at provider:
- From:
your-domain.com - To:
www.your-domain.com
- From:
Solution 2 (Advanced):
- Provider must support ALIAS/ANAME records
- Or CNAME flattening
- Not all providers offer this
Subdomain (.stayoa.app)
Subdomain doesn't work
Symptom: your-slug.stayoa.app shows error
Cause: Slug incorrect or property not published
Solution:
-
Check slug in Property → Website tab
-
Property status must be
Published -
Slug may only contain lowercase letters, numbers, hyphens
-
Slug must be unique
Remove Domain
Domain removed but still accessible
Cause: DNS cache
Solution:
- Delete DNS entries at provider
- DNS cache: Up to 24 hours (due to TTL)
- Clear browser cache
- Test in incognito mode
Primary Domain
Redirects don't work
Setup: Non-primary domains should redirect to primary
Check:
-
Is primary domain set? (star icon)
-
Are all domains status
Active? -
Test with curl:
curl -I https://other-domain.comShould show 301 redirect to primary
Problem: No redirect
Solution:
- Only Active domains redirect
- Primary domain must be Active
- Non-primary must also be Active
DNS Provider Specific
Cloudflare
Problem: Orange cloud active
Solution:
- Click on orange cloud → becomes gray
- CNAME must be
DNS only(gray) - Orange cloud proxies traffic and prevents automatic SSL issuance
GoDaddy
Problem: Redirects configured
Solution:
- Remove all redirects
- Only use CNAME/A records
Hostpoint
Problem: DNS editor complex
Solution:
- Enable "Advanced settings"
- Create CNAME records manually
- Don't use "Standard" records
Debugging
Check DNS propagation
Tools:
- whatsmydns.net
- dnschecker.org
- mxtoolbox.com
Check:
-
Enter your domain
-
Select CNAME or A record
-
Check if correct values worldwide
Browser cache
Problem: Old version displayed
Solution:
-
Hard refresh: Ctrl+Shift+R (Windows) / Cmd+Shift+R (Mac)
-
Clear browser cache
-
Test in incognito/private mode
Contact Support
Have ready:
- Domain name
- Domain provider
- Screenshot of DNS settings
- Status message from Stayoa
- Time of configuration
Contact:
- support@stayoa.app
- With above information