Skip to main content
Domains in Userplane represent the websites where your customers will use recording links. Adding and verifying a domain enables first-party branded links and unlocks per-domain recording preferences.

Why add a domain

  • First-party branding — recording links appear to come from your own domain rather than a generic Userplane URL.
  • Per-domain preferences — configure what data is captured (console logs, network activity, client actions) for each domain. See Domain Recording Preferences.
  • Trust — customers are more likely to engage with a recording link that matches your brand.

Domain statuses

StatusMeaning
PendingThe domain has been added but verification is not complete. You cannot create branded links or configure preferences until verification succeeds.
VerifiedDomain ownership is confirmed. Branded links and per-domain recording preferences are active.
RevokedVerification was revoked. The domain must be re-verified to use it.

Viewing domains

Go to Workspace Settings > Domains to see all domains. Each domain shows its name, status, and creation date.

Adding a domain

1

Open Domain settings

2

Click Add Domain

Click Add Domain and enter your domain (e.g. app.example.com).
3

Configure the domain

After adding, the domain appears in a Pending state. You can review its configuration before proceeding to verification.
4

Verify ownership

Follow the domain verification process to confirm ownership and unlock branded links and recording preferences.

Verifying a domain

Userplane uses a token-based verification process. See Domain Verification for the full walkthrough.
1

Start verification

Select the pending domain and click Verify. You can also send the instructions to a developer via email.
2

Add the script to your site

Copy the provided script tag and add it to your website’s HTML.
3

Trigger the check

Click Verify in Userplane to trigger the check. The verification token expires after 5 minutes.
4

Verification complete

Once the token is found and valid, the domain status changes to Verified.

After verification

Once a domain is verified:
  • You can create branded recording links using this domain.
  • Domain recording preferences become active.
  • You can remove the verification script tag from your website.

Managing domains

Select a domain to view its details, trigger re-verification, or delete it.
Deleting a domain removes it from your workspace. Existing recording links that use this domain will no longer be branded, but the links and recordings themselves are preserved.