---
title: Embed domains for iframes
description: Verify domains allowed to embed DistantRace results and registration widgets
order: 40
---

# 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

1. Enter the domain (e.g. `www.myrace.lv`) — no `https://` prefix
2. Save — DistantRace shows a **DNS TXT record** to add at your DNS provider
3. 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](embedding-results-on-your-website.md)
- 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](whitelabel-and-enterprise-setup.md).

## Related

- [Whitelabel and enterprise setup](whitelabel-and-enterprise-setup.md)
- [Embedding results on your website](embedding-results-on-your-website.md)
- [Introduction to integrations](../integrations/introduction-to-integrations.md)