Skip to content
Deckyard

Embedding

Put a Deckyard presentation on another page with an iframe. You can embed a published edition from your instance, or host a standalone HTML export yourself.

Embedding from Your Instance

Section titled “Embedding from Your Instance”
  1. Open Share > Public and publish the deck.
  2. Copy the Embed URL, or expand Snippets for your own site and copy the iframe snippet.
  3. Paste it into your website’s HTML or its embed block.

Use the /embed/ address. The public /p/ page refuses to load inside a frame.

<iframe
  src="https://your-instance.com/embed/12345678-1234-4234-8234-123456789abc/1"
  title="Quarterly review"
  width="800"
  height="500"
  loading="lazy"
  allow="fullscreen"
></iframe>

Replace the example address with the one copied from your instance. Give the frame a descriptive title and size it to fit your site’s layout, including the viewer’s controls.

The UUID identifies the publication; the final number identifies the edition. The frame keeps showing that edition when you edit the source deck or publish a later version. To show a new edition, replace the iframe’s URL with its new Embed link.

Language

Section titled “Language”

For a multilingual deck, select a language in the Public tab before copying the snippet. It adds a query such as ?lang=nl. The edition route accepts the language choice; the old player’s controls, ui, start, loop and allowedOrigins options do not configure edition embeds.

Existing SDK Integrations

Section titled “Existing SDK Integrations”

The standalone embed SDK was removed in Deckyard 1.95.0. Replace its script and JavaScript setup with a plain iframe pointing at an edition’s Embed URL. The former SDK methods, events and message protocol are no longer a supported integration.

Old embed URLs redirect to the first edition only after the instance administrator converts the old publication. Use the versioned URL from the Public tab for new embeds.

Static Embed (No Instance Needed)

Section titled “Static Embed (No Instance Needed)”

The HTML export produces a standalone .html file that can be hosted on your own static site. Embed that file with an iframe:

<iframe
  src="/my-deck.html"
  title="My deck"
  width="800"
  height="500"
  loading="lazy"
  allow="fullscreen"
></iframe>

This is also a snapshot. Replace the hosted file to update it. Uploaded images and curated or uploaded fonts are embedded; remote stock images and externally managed fonts can still need a network connection. The HTML export’s viewer options are separate from the published edition route.

Troubleshooting

Section titled “Troubleshooting”
  • The frame refuses to load: check that you copied the /embed/ URL, not the public /p/ URL.
  • 404 Not Found: check the complete publication UUID and edition number. An old link may still need administrator conversion.
  • 410 Gone: the edition was withdrawn. Ask its author for a new public edition.
  • Edits do not appear: publish a new version and replace the iframe URL. Existing editions stay fixed.
  • Controls are clipped: increase the frame’s height and check it at the narrowest width your site supports.
Section titled “Related”