# Embedding a board in a post

> Inserting a Canvas board into a blog post with its animation intact, and why editing the board afterwards does not silently change the published article.

Source: https://www.revquix.com/docs/canvas/embedding-a-board-in-a-post
Last verified: 2026-09-04

---

A board can go straight into a blog post, animation and all.

In the post editor, type `/` and choose **Canvas diagram**. A picker appears; pick
one of your boards and it becomes a figure in the article.

## It is a picture, not an embedded app

The diagram ships as an SVG image. The animation is drawn into the SVG itself, so it plays without
running any code.

> **Note** - Which is why it works everywhere
>
> An image is indexable with real alt text, it is kilobytes rather than megabytes, and it survives RSS
> and email - none of which is true of an embedded frame. Readers on slow connections get the diagram
> rather than a loading box.

## The version is pinned

This is the part worth understanding.

When you insert a board, the post records **which version of it you inserted**. Editing that board
afterwards does **not** change the published article.

> **Warning** - This is deliberate, and it is the opposite of how most embeds behave
>
> A live embed means a diagram you tidied up six months later silently rewrites an article you already
> published - possibly into something that no longer matches the words around it.
>
> So the article keeps the version it was written with. When the board has moved on, the editor tells
> you and offers **update to latest**. Taking it is a choice you make, not something that happens to
> you.

The check runs when you ask for it rather than every time the editor opens, so a post with eight
diagrams does not fire eight lookups before you have done anything.

## What inserting actually does

The figure is rendered when you insert it, not when you publish - so what you see in the editor is
the real artifact rather than a promise, and publishing cannot fail on a render.

Rendering produces an image and stores it. That image is what readers load.

> **Warning** - Embedding a private board publishes the drawing
>
> The board's visibility setting does not gate the embedded image - the image is a snapshot, stored
> separately from the board. So a **Private** board can be inserted, and once the post is published
> anybody reading it sees that diagram.
>
> The board stays private: nobody can open it in Canvas, fork it, or see anything you draw on it
> afterwards. But the version you inserted is out there. Check the board before inserting one you have
> been sketching freely on.

An **empty** board is refused rather than inserted as a blank figure.

## Related

- [Animating a flow](https://www.revquix.com/docs/canvas/animating-a-flow) - Giving the diagram something to show.

- [Sharing a board](https://www.revquix.com/docs/canvas/sharing-a-board) - Making it readable first.