video — Lattice component

video

ImageryCanvasProse

A video as a static, PDF-safe embed: a poster that links to the clip, a play badge, the provider's name, and a scannable QR to the same URL — never a live iframe.

Open in Playground
Variant

Use to put a YouTube / Vimeo / TikTok / Instagram video on a slide. Because the deck renders to a static PDF (and the engine bars iframes), a video slide shows a POSTER with a play badge + provider label — the poster is a clickable link in the HTML/PDF — and, when you add the qr modifier, a scannable code the room can scan to watch. Two compositions: companion (a claim leads on the left, the clip proves it on the right) and gallery (a contained, matted exhibit). Author the URL as a bare bullet; add an optional caption and an optional poster override. Provider is auto-detected.

visualshowcasepitch

When to use

  • A clip makes the point better than a screenshot. A product walkthrough, a customer testimonial, a demo reel — anywhere motion carries the argument. The slide shows a clean poster; the room scans the QR (or clicks it in the HTML/PDF) to watch.
  • The URL is all you have to write. Paste the YouTube / Vimeo / TikTok / Instagram link as a bare bullet; the provider is detected and the QR is generated for you. Add a poster bullet only when you want a specific still (required for Instagram, whose thumbnails aren't fetchable).
  • Closing / hand-off slides. A 'watch the full demo' or 'see the launch film' send-off pairs a poster with a scannable code the audience takes with them — the same pattern as the QR closing/divider variants.

When not to use

  • Expecting it to autoplay in the PDF. A PDF is paper — it can't play video, and the engine bars iframes for security. video is a poster + scannable link by design. If you need in-app playback, that's a separate interactive surface, not a boardroom deck.
  • A wall of caption. The caption is one line — 'Scan to watch', a title, a runtime. If you're writing a paragraph about the video, put it in a content slide and drop the clip in as a supporting video.
  • Instagram with no poster. Instagram's public thumbnails aren't fetchable, so an Instagram video with no poster bullet falls back to a plain placeholder tile. Author a poster for a real still.

Common mistakes

  • The caption or poster bullet has no trailing ` caption / poster ` inline-code key. The transform only recognizes a caption/poster bullet by its trailing key — a plain bullet with no key is invisible to the payload resolver, so the caption never appears and the poster override is silently dropped.
  • Authoring more than one URL bullet, expecting a second clip or a contact-sheet grid. The transform stops at the FIRST bullet whose text or link a provider recognizes — any additional URL bullets are silently ignored, not turned into a second video; only one clip renders per section.

Authoring

<!-- _class: video companion -->

## Watch the 90-second product tour.

One screen, one story — the fastest way to see the product work.

- https://www.youtube.com/watch?v=aqz-KE-bpKQ
- A guided walkthrough `caption`

Slots

SlotSelectorRequiredDescription
headingh2noOptional heading — the so-what of the clip, not 'Video'.
video.video-embedyesThe video URL, authored as a bare bullet (- https://youtube.com/watch?v=…). Provider is auto-detected; the transform builds the poster + play badge + QR.
caption.video-embed figcaptionnoOptional caption bullet — a plain bullet line ending with the caption marker (see Authoring below for the full syntax).

Variant decision rule

  • default (no modifier)A standalone video callout with no strong claim beside it — poster plus meta column, the simplest look.
  • companionA specific claim leads the slide and the clip proves it — text and poster split left/right.
  • galleryThe video is more exhibit than pitch — contained on a matte the way a diagram or screenshot would be.
  • qrThe room should be able to open the clip on their own phones — combines with any other variant to add a scannable code beside the poster.

Variants

companioncompanion

The player beside the claim it proves.

<!-- _class: video companion -->

## companion seats the player beside its pitch.

Ninety seconds, unscripted: signup to a published deck without touching support.

- https://www.youtube.com/watch?v=aqz-KE-bpKQ
- Ree A., Head of Ops at Northwind `caption`
- video-poster.svg `poster`

gallerygallery

A contained, matted exhibit.

<!-- _class: video gallery -->

## gallery mats the player like an exhibit.

- https://vimeo.com/1084537
- The reference onboarding walkthrough, contained on its matte. `caption`
- video-poster.svg `poster`

qrqr

Adds a scannable code; combines with any look.

<!-- _class: video companion qr -->

## qr hands the video to the room’s phones.

The full 90-second tour — scan to open it on your phone.

- https://www.youtube.com/watch?v=aqz-KE-bpKQ
- Scan to watch `caption`
- video-poster.svg `poster`

Related

  • imagethe visual is a still photo or screenshot, not a video
  • closingthe send-off is a call to action with a QR, not a specific clip
  • diagramthe motion you want is an animated process — a Mermaid diagram may say it statically