How to use embed integrations
Embed external content from supported sources (Figma, Google Docs/Sheets/Slides, Miro, YouTube, and others) into journey maps. Covers what's supported and how to embed correctly from each source.
Embed live content from tools your team already uses, like a Figma frame, a Google Doc, a Miro board, or a YouTube video, directly onto a journey map card. Embeds are link-based: paste a share link and the content renders in the card.
Unlike metrics and planning integrations, embeds need no account-level connection and no authentication setup. There's nothing to switch on in Account Settings. Each embed works from the share link you paste, so the only thing that decides whether it renders is the link type and the source's own sharing settings.
Supported sources
Smaply embeds content from these sources:
Figma - embed a specific frame or file
Google Docs, Google Sheets, Google Slides - embed a document, spreadsheet, or presentation
Miro - embed a board or a single frame
Mural - embed a mural
YouTube - embed a video
Power BI - embed a report
Tableau - embed a dashboard
Monday.com - embed a workspace view
SharePoint (Excel, Word, PowerPoint) - embed an Office file
OneDrive (Excel, Word, PowerPoint) - embed an Office file
Generic web URLs also work. When a page exposes the right metadata, the embed renders as a rich link preview.
Get a shareable link from each source
The link you paste has to be one that anyone with access to the map can open, not a private editing URL tied to your own login. Open the source, set its sharing so the people who will view the map can reach the content, then copy the link the source gives you for sharing or embedding. Specifics differ by source.
Figma
In Figma, select the frame or file you want, open the share dialog, and turn on link sharing so anyone with the link can view. Copy that share link. To embed a single frame rather than the whole file, copy the link with the frame selected.
Google Docs, Sheets, and Slides
In the Google file, open Share, set General access so anyone with the link can view, and copy the link. If access stays restricted to named people, viewers without those Google accounts see a request-access screen instead of your content.
Miro and Mural
In Miro or Mural, open the board's share settings and enable public or anyone-with-the-link access, then copy the share link. A board left private to your team renders blank for anyone outside it.
YouTube
Copy the video's URL from the address bar or the Share button. Set the video's visibility to Public or Unlisted; a Private video does not play for other viewers. No further sharing setup is needed.
Power BI, Tableau, and Monday.com
Use the link these tools generate for sharing or embedding a report, dashboard, or view, and make sure it's set so your map's viewers can reach it. Access to the underlying data still depends on each viewer's own permissions in the source tool.
SharePoint and OneDrive (Office files)
SharePoint and OneDrive embeds use an embed code rather than a plain share link. In the Office file, generate the embed code, and set the file's sharing so your viewers can open it. Paste the code's source URL into the embed.
Any other web page
Paste the page's URL. Pages that expose Open Graph metadata render as a rich link preview; others fall back to a plain link.
When an embed does not render
If an embed shows a blank card, a permission prompt, or a login screen for the source tool, the cause is almost always the source's sharing setting, not Smaply. Whether embedded content is visible depends entirely on the source platform's own sharing and privacy settings, and this applies to viewers of a shared HTML view as well as to anyone without an account on the source tool.
Open the source, confirm sharing is set so the people viewing the map can reach the content (typically anyone-with-the-link or public), copy the link again, and re-paste it. If the link works for you because you're signed in to the source but not for a logged-out viewer, the sharing setting is still too restrictive.
Related topics
Last updated