Domain
The Domain page lets you replace your marketplace's default subdomain (for example, acme.on-yclas.com) with a domain you own, like example.com. Setup is a single CNAME record — Yclas Neo handles SSL provisioning automatically.
Open the Domain page
- Go to Sites in the admin panel
- Click on your site to open its Home page
- In the sidebar, expand Build → General and click Domain
Permissions
Only team members with permission to update a site can change its domain. See Account settings for team roles.
Default subdomain
Every site is reachable on its subdomain — yoursite.on-yclas.com — even after a custom domain is configured. The subdomain always works as a fallback so nothing breaks during DNS propagation or if you remove a custom domain later.
Subdomains can't be renamed
The subdomain is generated from your site name when the site is created. To change it, rename the site — but the underlying subdomain slug is fixed. To move to a different URL, add a custom domain.
Adding a custom domain
Enter the bare domain you own (for example, example.com) and save. Yclas Neo:
- Lowercases and trims the value automatically
- Serves both the apex (
example.com) and thewwwvariant (www.example.com) from the same configuration - Rejects the admin domain, your existing subdomain, and any domain already claimed by another site
Enter the bare domain
Enter example.com, not www.example.com and not https://example.com. The www variant is wired up automatically once the apex is saved.
Domain rules
The following are rejected when you save:
- Domains that aren't valid hostnames (must be at least two labels separated by dots)
- Domains that include a protocol (
http://,https://) or a trailing slash - Domains that begin with
www.— enter the apex instead - The admin panel's own domain
- Your marketplace's existing subdomain or the storefront domain itself
- Domains already claimed as a custom domain or subdomain by another site
DNS setup
Once a custom domain is saved, the page shows a step-by-step timeline and a table with the exact DNS values to add at your registrar.
The CNAME record
| Field | Value |
|---|---|
| Type | CNAME |
| Host / Name | www (for the www variant) or @ (for the apex) |
| Value / Points to | Your CNAME target (shown on the Domain page, e.g. cname.on-yclas.com) |
| TTL | Auto / Default |
Why a CNAME?
CNAMEs point at a hostname you control rather than a fixed IP address. When servers are migrated, every customer's custom domain follows automatically — only the CNAME target's DNS changes, and you don't have to do anything.
Apex support
The apex root (example.com) requires either:
- CNAME flattening — Cloudflare (free) and several modern DNS providers support this
- An ALIAS or ANAME record — AWS Route 53, DNSimple, and others
If your registrar rejects a CNAME at the apex, use the www variant only, or move DNS to a provider that supports apex CNAMEs.
Checking DNS
Click Check DNS to verify your CNAME has propagated. The page inspects the www record's target and reports one of three states:
- Pending — no CNAME found yet. DNS can take a few minutes to propagate; try again shortly.
- Wrong target — a CNAME exists but points somewhere other than your CNAME target. Update the value at your registrar.
- Live — your CNAME matches. HTTPS activates on the first visit (10–30 seconds while the certificate is issued).
SSL / HTTPS
SSL certificates are issued on-demand the first time a visitor loads your custom domain. There's nothing to configure or renew — Yclas Neo handles issuance and renewal automatically.
To activate the certificate, simply visit https://your-domain.com in a browser. The first request takes 10–30 seconds while the certificate is provisioned; subsequent requests are served normally.
Using Cloudflare
Cloudflare's proxy (the orange cloud) hides your CNAME from public DNS, which means the Check DNS button will keep reporting Pending even when everything is set up correctly. Two options:
- Temporarily switch to DNS-only (grey cloud), run Check DNS to confirm the setup, then switch back to proxied
- Skip the check — set Cloudflare's SSL/TLS encryption mode to Full or Full (strict) so HTTPS traffic reaches Yclas Neo correctly, and your marketplace will work regardless of what the checker reports
Removing a custom domain
Use Remove custom domain to disconnect a domain. The storefront immediately falls back to the site's subdomain, and the domain becomes available for another site to claim. The subdomain itself keeps working throughout.
Troubleshooting
CNAME at apex is rejected Your provider doesn't support CNAME flattening. Use www only, or switch DNS to Cloudflare (free).
Still pending after an hour DNS hasn't propagated yet. Check from a different network, or use a tool like whatsmydns.net to inspect propagation globally.
HTTPS doesn't activate Make sure your CNAME points at the exact target shown on the Domain page. A misconfigured CNAME will block certificate issuance.