Embed · GitBook

Put an interactive demo in GitBook docs.

GitBook's Embed block renders URLs through Iframely and its CSP blocks raw iframes — so a lane needs the linked-image pattern. What works, what doesn't, honestly.

Where it goes: A GitBook space for docs or guides, where a workflow page would benefit from a click-through.

The snippet

One iframe

The share modal generates this for your lane; the example uses a placeholder address. 

<iframe src="https://acme.tellane.com/l/pipelines-tour" width="100%" height="640" frameborder="0" allowfullscreen></iframe>

Steps

In GitBook

  1. In Tellane, open the lane → Share → copy the public link.
  2. In GitBook, you can try the Embed block first: paste the URL on an empty line and press Enter. GitBook resolves it through Iframely; URLs without embed metadata render as a link card, not a player.
  3. For a reliable result, use the linked-image pattern: take a screenshot of the lane's first stop (orange hotspot visible), insert it as an image block, and link the image to the lane URL.
  4. Add a one-line caption under the image — 'Drive the demo →' — linked to the same URL for readers whose eyes skip images.
  5. Publish and click through from the live page once.

Proof

This is what the embed looks like

A lane embedded on this page, the same way yours will be on GitBook. Drive it.

osprey.app/pipelines — captured with Tellane
LIVE DEMO
Osprey
Overview
Pipelines
Accounts
Reports
Settings
PIPELINES / Q3

Q3 enterprise pipeline

Invite teammate
Open pipeline$4.2M +12%
Win rate31% +4pts
Avg. cycle24d −6d
Weekly closed-wonJun — Aug
Meridian FreightNegotiation$380K
Cobalt HealthProposal$210K
Aster & Co.Discovery$95K
THIS PAGE EATS ITS OWN DOG FOOD
You're looking at a real Tellane demo.

Osprey is a fictional app we captured in five minutes. Click the glowing dots to drive it yourself — three stops, no sales call.

Lane progress
Embedded lane · the same player GitBook will show

If it doesn't work

What breaks, and the fix

  • The Embed block shows a link card instead of the player. GitBook embeds URLs through Iframely, which needs the target to publish embed metadata. A plain app URL renders as a card — use the linked-image pattern above.
  • Pasting the iframe snippet as code does nothing. Expected — GitBook's content security policy blocks external HTML tags in pages; there is no raw-HTML block. The image link is the supported route.

FAQ

Questions

Will the Embed block ever show the player?

Only if the demo URL publishes embed metadata Iframely recognises. Test any URL at iframely.com; if it previews as a player there, the GitBook block will match it.

Other platforms

Embed guides

EmbedWebflowEmbedWordPressEmbedFramerEmbedNotionEmbedHubSpot CMSEmbedWixEmbedSquarespaceEmbedGhostEmbedDocusaurusEmbedConfluenceEmbedZendesk GuideEmbedEmail (Gmail, Outlook, HubSpot, Mailchimp)EmbedBubbleEmbedCarrdEmbedReadMeEmbedWebflow CMS collectionsEmbedIntercom ArticlesDocsPublishing, sharing, and embedding