Step-by-step DNS setup for your Aveiro site — add records at your registrar, verify SSL, and make your domain the primary public URL with automatic redirects from your aveiro.page slug.
Open Settings → Custom domain, add your hostname, copy DNS records to your registrar, refresh until verified, then publish site settings. SSL provisions automatically; your slug URL redirects to the custom domain when connected.
Why connect a custom domain
Your Aveiro site ships with a preview URL:That works on day one. A custom domain (www.yourbrand.com, docs.yourproduct.com) helps with:
Brand trust — readers recognize your hostname in the address bar
Email alignment — sending domains and site URLs look coherent
SEO — one canonical host instead of split signals between slug and brand domain
Shareability — links in campaigns and social posts match what you print on business cards
Aveiro provisions SSL automatically after DNS verification. No manual certificate uploads.
Before you start
Requirement
Why
Site saved in Aveiro
Domain panel needs a persisted site record
DNS access at your registrar
You will add CNAME or A records Aveiro shows
Published content (recommended)
Visitors see something useful on go-live
15–60 minutes for propagation
TTL and registrar caching vary
You do not need to delete your *.aveiro.page slug — once connected, it redirects (301) to your custom domain with the same path.Full URL model: Preview and live URLs.
Step 1 — Add the domain in the editor
Open your site in the editor.
Go to Settings → Site → Custom domain.
Click Edit and enter your hostname (e.g. www.example.com or docs.example.com).
Save — Aveiro displays the DNS records to add.
Use the exact hostname you want visitors to type. Apex (example.com) vs www depends on your registrar — follow the record types Aveiro shows for your choice.Platform reference: Custom domains.
Step 2 — Add DNS records
Log in to your domain registrar (Cloudflare, Namecheap, Google Domains, Route 53, etc.) and create the records exactly as listed in the panel:
Copy host/name and value/target character-for-character
Remove conflicting records on the same host if verification fails
Prefer the record type Aveiro specifies (CNAME vs A)
Propagation takes time
DNS changes can take minutes to several hours. Use Refresh and check DNS in Aveiro instead of assuming failure after five minutes.
Step 3 — Verify and wait for SSL
Return to Settings → Custom domain.
Click Refresh and check DNS.
When status shows connected, SSL provisioning begins automatically.
Publish Site settings so the live site serves on the new domain.
Status meanings:
Status
Meaning
Not connected
No domain configured yet
Pending
Records added — waiting for DNS verification
Connected
Domain serves your published site with SSL
Step 4 — Update external links
After go-live:
Update campaign links and social bios to the custom domain
Set site SEO defaults and key page titles — canonical URLs follow the custom domain
Test https://your-slug.aveiro.page — it should redirect to the same path on your domain
Can I use a subdomain for docs only?Yes — docs.product.com is a common pattern. Each Aveiro site connects one primary custom hostname.Does connecting a domain publish draft pages?No. Domain connection is site settings. Page content still publishes separately. See Publishing settings vs content.Will my slug URL break old links?No — it redirects to the custom domain with the same path when configured.
