Notion Logo

Embed interactive images in Notion

picpins hotspot images can be embedded in your pages via Notion's embed block — with a few limitations you should know before you start.

Suited for internal wikis, onboarding documents, and public pages.

In three steps to your embedded image

1

Build the picpins image

Upload a photo, place markers, fill tooltips. Auto-save handles saving.

2

Copy the share link

In the picpins dashboard click "Share" and copy the public link — not the embed code.

3

Insert in Notion

In the Notion page paste the link and choose "Create embed". Notion loads picpins as an iframe.

How to embed picpins

Notion is a special case: the platform allows embeds, but only via its own iframe-based embed logic — no direct HTML insertion like in WordPress or Shopify. Instead you use the picpins share link, which Notion automatically embeds in an iframe.

1. Share link instead of embed code

Notion does not allow free HTML with custom scripts. Instead you need the public share link of your picpins image. In the picpins dashboard click on the image, then "Share" — you get a URL like https://picpins.com/v/[token].

2. Insert embed in Notion

In the Notion page at the desired position type /embed. Notion offers "Create embed". In the popup paste the picpins share link, click "Embed link".

Alternative: just paste the link into an empty line of the Notion page — Notion recognizes URL patterns and automatically suggests "Create embed" as an option.

Note: Notion shows the embed in a container with fixed height by default. Use the drag handles at the bottom to adjust the height to your image, otherwise tooltips get cut off.

3. Public pages and sharing

When you share the Notion page publicly (e.g. as a Notion site or via "Share to web"), the embed works there the same way. Both internal Notion workspaces and public pages support iframe embeds.

For Notion sites via providers like Super.so, Potion, or Notionlytics the same applies — the iframe is taken over.

4. Workaround: Static image + link

If the iframe embed is too restrictive (e.g. for Notion Free plans without public pages), you can also embed a screenshot of your picpins image in Notion and place a link to the interactive version below. Works in any Notion context, but of course without hotspot functionality directly in the Notion page.

Embed code to copy
https://picpins.com/v/dein-token-hier

What picpins is great for on Notion

Internal onboarding wiki

Office photo with hotspots on workstations, printers, kitchen, emergency exits — onboarding tour without long text.

Product or feature documentation

Software screenshot, markers on every UI element with explanation. Documentation people actually read.

Travel travelogue

Photo of the hotel room, the beach, the city — hotspots with personal tips and recommendations.

Project handover doc

Screenshot of the final state of a project, hotspots on components with owners and files.

Tips and gotchas

Frequently asked questions

Why can I not paste an embed code in Notion?

Notion does not allow free HTML or custom JavaScript in pages for security reasons. Instead external content is embedded via iframes — you only provide the URL, Notion builds the container around it.

Does picpins work on Notion Free plans?

Yes, on the personal Free plan the embed function works without limit. Public pages ("Share to web") are also available on the Free plan.

My embed gets cut off — what to do?

Notion gives the iframe a default height that is often too small. Click on the embed, then a drag handle appears at the bottom center — drag it down until the entire image plus tooltip area is visible.

Are the hotspot tooltips fully functional?

Yes, all click, hover, and tap interactions are active in the iframe. Tooltips open like on the actual picpins page. Only restriction: tooltips that try to extend beyond the iframe edge get clipped by the iframe.

Can I embed picpins in Notion databases (galleries, tables)?

Not directly in a database field — Notion fields expect text, numbers, selects. Workaround: on the detail page of a database entry (each entry opens as its own page) place the embed manually.

Multiple picpins in a Notion page — does it work?

Yes. Each embed is its own iframe, you can place as many as you like on a page. Performance stays okay because Notion lazy-loads the iframes as soon as they become visible.

What happens when I export the Notion page as PDF?

iframes are not resolved in Notion's PDF export — you only see an empty placeholder with the link. For print/PDF use cases embed a static screenshot of the picpins image instead.

Does it work in Notion-based site builders like Super.so?

Yes, embeds carry over to Super.so, Potion, and similar tools. Sometimes with small layout adjustments — the tools render the iframe in their theme environment.

picpins works in Notion too — with a few limitations.

Via the share link instead of embed code, with adjusted iframe height. Plenty for wikis and onboarding docs.