Domain Verification Guide

This guide is for developers who need to add the Userplane script to a website and verify domain ownership. A workspace admin will typically send you these instructions via the “Send to Developer” button in Workspace Settings.

Overview

Userplane verifies domain ownership by checking for its script on your website. The process is:

Add the Userplane meta tag and script to your site’s HTML.
The workspace admin clicks Verify in Userplane.
Userplane checks your domain for the script and, if found, marks the domain as verified.

Step 1: Add the script

Paste the following into the <head> of your site:

<!-- Sets workspace ID for screen recording -->
<meta name="userplane:workspace" content="YOUR_WORKSPACE_ID" />

<!-- Loads Userplane screen recording script -->
<script type="module" src="https://cdn.userplane.io/embed/script.js"></script>

Replace YOUR_WORKSPACE_ID with the workspace ID provided by your admin. You can also copy the exact snippet (with the workspace ID already filled in) from Workspace Settings > Domains in the Userplane dashboard.

The <script> tag should be placed as early as possible in the <head> to ensure it initializes before other scripts run. See Installation for detailed placement guidance.

Step 2: Deploy

Deploy the page with the script tag. The page must be publicly accessible — verification will fail if the page is behind a login wall or not yet deployed.

Step 3: Trigger verification

After deploying, if you’re a member of the workspace you can trigger verification yourself from Workspace Settings > Domains. Otherwise, let your workspace admin know the script is deployed and ask them to click Verify on your behalf. The verification check runs immediately.

Step 4: Confirmation

Once the token is found and valid, the domain status changes to Verified. You’ll see a confirmation in the dashboard.

Time limit

The verification token expires after 5 minutes. If the token expires before verification completes, the admin must generate a new token from Workspace Settings.

Troubleshooting

Issue	Solution
Verification fails immediately	Check that the script tag is on a publicly accessible page and the page is deployed.
Token expired	The 5-minute window has passed. Ask the admin to generate a new token.
Page behind authentication	The verification page must be publicly accessible — no login wall.
Script blocked by CSP	If your site uses Content-Security-Policy headers, allow `*.userplane.io` in `script-src` and `frame-src`. See Installation.

After verification

Once the domain is verified, keep the script on your site — it is needed for recordings to work. The meta tag and script serve double duty: they verify the domain and enable screen recording.

Installation — detailed guide on script placement, CSP, redirects, and browser support.
Domain Verification — the admin-side verification process.
Domains — why domains matter.

Getting Started

AI Agents

SDK Reference

Framework Guides

Platform Guides

Privacy & Data

Overview

Step 1: Add the script

Step 2: Deploy

Step 3: Trigger verification

Step 4: Confirmation

Time limit

Troubleshooting

After verification

​Overview

​Step 1: Add the script

​Step 2: Deploy

​Step 3: Trigger verification

​Step 4: Confirmation

​Time limit

​Troubleshooting

​After verification

​Related articles

Overview

Step 1: Add the script

Step 2: Deploy

Step 3: Trigger verification

Step 4: Confirmation

Time limit

Troubleshooting

After verification

Related articles