> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pullstory.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Embed a pull story

> Drop a pull story inline in docs, changelogs, blog posts, or Notion.

## 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 (recommended for docs)

```html theme={null}
<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:

```html theme={null}
<iframe
  src="https://pullstory.com/a/vercel/next.js/12345/artifact_01hq..."
  width="100%"
  height="480"
  frameborder="0"
/>
```

See the [share individual artifacts cookbook](/cookbooks/share-individual-artifacts) for more.

## Notion, Linear, Slack

All three auto-unfurl pull story links. Just paste the URL — no embed code needed.

<Frame>
  <img src="https://pullstory.com/brand/slack-unfurl.png" alt="Pull story link unfurled in Slack" />
</Frame>