Skip to main content

The embed URL

Every pull story has a deterministic URL:
https://pullstory.com/pr/{owner}/{repo}/{number}
You can link to it, iframe it, or share the URL directly — all three work.
<iframe
  src="https://pullstory.com/pr/vercel/next.js/12345"
  width="100%"
  height="600"
  frameborder="0"
  allow="autoplay"
  allowfullscreen
/>
The iframe picks up your theme (light/dark) automatically based on the parent page’s prefers-color-scheme.

Sharing a single artifact

Each scene in a pull story is also an artifact with its own URL:
https://pullstory.com/a/{owner}/{repo}/{number}/{artifactId}
Use this to share just one diagram or code-diff without the full video:
<iframe
  src="https://pullstory.com/a/vercel/next.js/12345/artifact_01hq..."
  width="100%"
  height="480"
  frameborder="0"
/>
See the share individual artifacts cookbook for more.

OG image for social

Pull stories also expose an OG image at:
https://pullstory.com/pr/{owner}/{repo}/{number}/opengraph-image
1200×630, rendered with the first diagram from the story. Use it in your own <meta property="og:image"> when linking to a pull story.

Notion, Linear, Slack

All three auto-unfurl pull story links. Just paste the URL — no embed code needed.
Pull story link unfurled in Slack