Custom domain delegation
Delegate a branded subdomain to OmniLab so embedded Pages can run under your own domain.
Use delegated custom domains when the embedded OmniLab experience should live under your brand's domain instead of .topage.co. A common setup is to keep the main website on www.example.com while OmniLab runs on a dedicated subdomain such as experience.example.com.
When delegated custom domains matter most
Choose this setup when:
- you want fully branded public URLs for the embedded experience
- the host website and the OmniLab flow should stay under the same brand-domain family
- final QR codes, paid media links, or campaign redirects must use the branded hostname
Recommended rollout path
If you need to launch quickly, start on the default OmniLab-hosted domain first. Move to a delegated custom domain when the final branded rollout is ready.
How custom domain delegation works
Choose the public hostname
Pick a dedicated subdomain such as experience.example.com or promo.example.com. In most cases, a subdomain is easier to manage than moving the root website domain.
Ask your DNS team to point it to OmniLab
Your DNS team usually creates a CNAME record, or another approved record type if your provider requires it, so the chosen hostname points to the OmniLab endpoint.
Confirm SSL provisioning
Wait until the branded hostname serves a valid certificate before you publish final links. During propagation, temporary certificate warnings can appear.
Retest the live experience
Check the standalone OmniLab page, the embedded website page, and any campaign links or QR codes that will use the new branded hostname.
DNS propagation can take time, sometimes up to 48 hours depending on the provider and TTL settings.
Typical embedding model
| Surface | Example |
|---|---|
| Host website | https://www.example.com/promo |
| Embedded OmniLab source | https://experience.example.com/summer-campaign?embedded=1 |
This keeps the website and the embedded experience in the same branded domain family while leaving the CMS page and the OmniLab Pages host as separate surfaces.
Go-live checklist
- Final branded hostname approved by the web or infrastructure team
- DNS record created and propagated
- SSL certificate active
- Standalone OmniLab URL working on the new hostname
- Embedded page tested for layout, permissions, cookies, and redirects
- Existing QR codes or media placements updated if they still reference the previous host