Boards
Embedding a board
Copy the iframe from the Share panel and a live board renders inside a page you own, updating as the board does.
Open **Share**, set the width and height you want, and copy the embed code. What you get is an iframe pointing at the board's public route. ```html title="Embed code" <iframe src="https://plnty.app/embed/<share-token>" width="800" height="600" frameborder="0" allow="fullscreen" style="border: none; border-radius: 8px;" ></iframe> ``` Paste it into a Notion page, a client portal, a docs site, a pitch deck tool that takes HTML, or anything else that renders an iframe. ## What the embed shows The board, live and read-only. It updates as the board does, so an embed placed in a status page on Monday shows Friday's work without anyone touching the page. Viewers can pan and zoom around it. They cannot edit, and they see none of the working chrome: no tool cards, no in-progress pills, no cursors. ## Embed or public link They are the same access with different framing, and the choice is about where the work should be read. - **Public link** when the board *is* the destination, and you want it full-screen - **Embed** when the board is one element in a page you control, surrounded by your own context An embed is the better choice for a recurring surface, because it makes the board a component of something you maintain rather than a URL somebody has to keep finding. :::caution[The embed is as public as the link] It uses the same share token, so anyone who can view your page can view the board, and anyone who reads the page source has the direct URL. Never embed a board you would not hand over. ::: ## Sizing it The width and height in the snippet are yours to change after you paste it. The board scales its view to the frame rather than cropping, so a short wide embed shows the whole board at a smaller zoom rather than showing a slice of it. Give it more room than feels necessary. A board is a spatial document and it reads badly through a letterbox. :::tip[Point the embed at the right board] An embed shows one board, so it is worth making a board specifically to be embedded: the approved directions, framed and locked, rather than the working board with six dead ends still on it. :::Open Share, set the width and height you want, and copy the embed code. What you get is an iframe pointing at the board’s public route.
<iframe src="https://plnty.app/embed/<share-token>" width="800" height="600" frameborder="0" allow="fullscreen" style="border: none; border-radius: 8px;"></iframe>Paste it into a Notion page, a client portal, a docs site, a pitch deck tool that takes HTML, or anything else that renders an iframe.
What the embed shows
Section titled “What the embed shows”The board, live and read-only. It updates as the board does, so an embed placed in a status page on Monday shows Friday’s work without anyone touching the page.
Viewers can pan and zoom around it. They cannot edit, and they see none of the working chrome: no tool cards, no in-progress pills, no cursors.
Embed or public link
Section titled “Embed or public link”They are the same access with different framing, and the choice is about where the work should be read.
- Public link when the board is the destination, and you want it full-screen
- Embed when the board is one element in a page you control, surrounded by your own context
An embed is the better choice for a recurring surface, because it makes the board a component of something you maintain rather than a URL somebody has to keep finding.
Sizing it
Section titled “Sizing it”The width and height in the snippet are yours to change after you paste it. The board scales its view to the frame rather than cropping, so a short wide embed shows the whole board at a smaller zoom rather than showing a slice of it.
Give it more room than feels necessary. A board is a spatial document and it reads badly through a letterbox.