Embed domains for iframes
Embed domains for iframes
Before embedding DistantRace results or registration widgets on your website — or hosting a whitelabel participant portal on your own domain — add and verify each domain at the club level.
Path: Manager console → Club → Embed domains
Add a domain #
- Enter the domain (e.g.
www.myrace.lv) — nohttps://prefix - Save — DistantRace shows a DNS TXT record to add at your DNS provider
- Click Verify after the TXT record propagates (may take up to an hour)
Verified domains appear with a green status. Only verified domains can embed iframes.
Disable without deleting #
Use Toggle active to temporarily block embedding from a verified domain without removing DNS verification. Re-enable when ready.
Per-event embedding #
After domains are verified, copy embed URLs from:
- Challenge → Settings → Iframe embedding
- Competition → Settings → Base (results, start list, registration widget)
Event-level settings inherit club-level domain allowlists.
Troubleshooting #
| Issue | Fix |
|---|---|
| Embed shows blank / blocked | Domain not verified or typo in domain name |
| Verification fails | Confirm TXT record at root or _distantrace host per instructions |
| Works on www but not apex | Add both example.com and www.example.com |
Whitelabel custom domains #
Verified embed domains also authorize your club's branded participant portal and themed login flows. DistantRace maps the domain to your organization for CORS, OAuth return URLs, and login-page branding.
Full overview: Whitelabel and enterprise setup.