How do I embed a video in a form?

Last updated: September 25, 2026

Onboarded doesn't have a video field. To put a video on a form, add a Content field and paste your video host's <iframe> embed code into an HTML block. The one hard requirement is that the host allows its player to be framed on another site.

Check that your host allows framing

Your embed renders inside the form page, so the video host decides whether it displays at all. Hosts send response headers — X-Frame-Options, or a frame-ancestors rule in their content security policy — that either permit or block framing on someone else's page. When a host blocks it, the block renders empty, and there's no setting on the Onboarded side that overrides it.

  • Vimeo and YouTube both allow framing and hand you ready-made embed code. YouTube serves ads around the player, which usually rules it out for compliance content like a safety orientation.

  • Video hosted on your own site, a storage bucket, or a website builder's asset URL often works — but some website builders block framing by default, so confirm before you build the form around it.

  • Consumer file-sharing links are the least predictable. Test one before you commit to it.

Add the video to the form

  1. Copy the embed code from your video host, usually under Share or Embed. Use the host's snippet rather than writing an <iframe> by hand — it carries the player attributes that host expects.

  2. Open your form in the editor and drag a Content field onto the page.

  3. Click the content block to edit it inline.

  4. In the editor toolbar, click Insert HTML block. A block labeled HTML appears with a text area inside it.

  5. Paste your snippet into the text area.

  6. Click outside the block to save, then open the form's preview link. The player renders where the block sits.

A typical snippet looks like this:

<iframe src="https://player.vimeo.com/video/123456789"
        width="100%"
        height="400"
        frameborder="0"
        allow="fullscreen; picture-in-picture"
        allowfullscreen></iframe>

Set width to 100% so the player scales with the form on a phone, and keep the host's allow and allowfullscreen attributes — those are what give the employee working playback controls.

Show a different video by language

A Content field stores its entire body per language, not just its label. The HTML block is part of that body, so one field can point at an English video for English and a Spanish video for Spanish. You don't need two forms or a conditional rule.

  1. Add the second language to the form if it isn't there yet.

  2. Switch the language selector in the form editor header to the language you want to author.

  3. Click the content block and replace the src in the HTML block with that language's video URL.

  4. Switch back and confirm the original language still points at the original video.

This works because a content field's body is its translation. On most other field types, translations cover only the label, hint, description, and placeholder text — not configuration.

An embedded video doesn't record whether the employee watched it.

The player belongs to the host, and Onboarded doesn't receive playback events from it. If you need the form to hold the employee on the page for the length of the video, pair the content block with a Timer field. If you need evidence they absorbed the content, use a graded quiz.

Verify

Open the form's preview link on desktop and on a phone. You should see:

  • The player rendered inside the form, not a link or a blank space.

  • Working play, pause, and volume controls.

  • The player scaled to the width of the form, without horizontal scrolling.

An empty block almost always means the host is refusing to be framed — try a different host and re-test before you change anything else. If the player appears but the controls don't respond, the snippet is missing the host's allow attributes; re-copy the embed code from the host instead of editing it by hand.

Related