Embed nodes on boards

Embed nodes let you drop a live, read-only mini-view of one of your other surfaces — a VTT scene, a world map, or a world’s wiki graph — directly onto a board. They’re a way to reference something while you plan, without leaving the board.

You can pan and zoom inside an embed, hover and click things to see details, and click through to the original surface when you want the full experience.

What you can embed

Scene

A VTT scene with its basemap, tokens, walls, and shapes. Pan around, hover a token to see it lift, click it to see who it represents.

World Map

A world map with its basemap, pins, regions, and paths. Click a pin to open the linked wiki page, hover a pin to reveal the region tied to it.

Wiki Graph

A read-only force-directed graph of a world’s wiki pages and their links. Click a node to open that page in the side panel.

Adding an embed

Open the Component Library drawer from the toolbar.
Find Scene, World Map, or Wiki Graph and drag the card onto the canvas.
A picker opens automatically with thumbnails of everything you can embed. Click one to confirm.

If you change your mind, dismiss the picker and the embed sits as a placeholder. You can reopen the picker any time with the Pick a scene… / Pick a world map… / Pick a world… button on the placeholder, or pick from the right-rail Inspector.

Moving and resizing

Each embed has a small frosted header bar along the top with the source’s name. Grab the header to move the embed around the board — the map area below is reserved for pan/zoom inside the embed itself, so dragging on the map pans the map, not the node.

Resize an embed by dragging any corner once it’s selected. The size is saved with the board.

Inside a Scene embed

Pan the map by clicking and dragging the map area.
Zoom with the scroll wheel or trackpad pinch.
Hover a token — it lifts slightly to show it’s interactive.
Click a token — a small card pops up with the token’s name, its size, initiative if any, and a portrait. If the token is linked to an actor, an Open actor sheet link takes you to the full sheet in a new tab.
Click Open in the header to open the full scene in a new tab.

Inside a World Map embed

Pan and zoom the map the same way.
Pins look exactly like they do on the standalone world map — same shapes, icons, and colours.
Hover a pin — any region tied to that pin fades in. This is how the regular world map handles pin-linked regions, and the embed matches.
Click a pin — if it’s linked to a wiki page, the Wiki side panel opens to that page. Your board stays in place.
Paths show their labels on hover by default; permanent labels honour the path’s own setting.
Click Open in the header to open the full world map in a new tab.

Inside a Wiki Graph embed

Pan by dragging empty space and zoom with the wheel/pinch.
Hover a node for its title.
Click a node — the Wiki side panel opens to that page (or the actor’s sheet, for actor nodes), without leaving the board.

The graph runs in a stripped-down mode inside the embed — no settings panel, no right-click menu, no pin/hide controls. For the full graph experience, open the wiki sidebar on the source world.

Tips

One embed per source isn’t a rule. Drop multiple wiki-graph embeds for different worlds side-by-side, or two scene embeds for the same scene at different zoom levels.
Edits don’t persist. Embeds are read-only by design — pan/zoom state is local to the embed and isn’t saved. Move tokens or pins from the standalone view if you actually want to change the source.
Pinch-zoom is captured by the embed. If you pinch on the embed, the embed zooms; your browser stays where it is. If you want to zoom the page itself, pinch outside the embed.

Access notes

Embedding a scene or world on a board doesn’t grant other people access to it.

If you share the board with someone who already has access to the embedded scene/world, they’ll see the embed normally.
If they don’t, the embed shows a “You don’t have access to this scene” placeholder where the map would be. The board still loads fine — they just can’t see the contents of that one embed.

To give them access, share the underlying scene or world directly.