> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Block Sharing

Share Blocks with your team as permalinks or embeddable HTML snippets.

Note

This action sends command information to our server and is explicitly opt-in. Read more about privacy at Warp on [our privacy page](https://www.warp.dev/privacy).

Share your blocks with a permalink or HTML embed. You can get started with shared blocks by opening the context menu and copying the command, output, or prompt.

## How to share blocks

-   [macOS](#tab-panel-743)
-   [Windows](#tab-panel-744)
-   [Linux](#tab-panel-745)

To share your blocks, follow these steps:

1.  On a finished block, click the context menu and select **Share…** or select the block and hit `CMD-SHIFT-S`.
2.  A modal will pop up that lets you title your block and customize it by selecting which parts of the block you want to share (e.g. command, output, prompt, etc.).
3.  Click either “Create link” or “Get embed” depending on how you want to share your block.
4.  The link or embed snippet will be copied to your clipboard.

To share your blocks, follow these steps:

1.  On a finished block, click the context menu and select **Share…**, or set up a key bind for Share Block in **Settings** > **Keyboard shortcuts**.
2.  A modal will pop up that lets you title your block and customize it by selecting which parts of the block you want to share (e.g. command, output, prompt, etc.).
3.  Click either “Create link” or “Get embed” depending on how you want to share your block.
4.  The link or embed snippet will be copied to your clipboard.

To share your blocks, follow these steps:

1.  On a finished block, click the context menu and select **Share…**, or set up a key bind for Share Block in **Settings** > **Keyboard shortcuts**.
2.  A modal will pop up that lets you title your block and customize it by selecting which parts of the block you want to share (e.g. command, output, prompt, etc.).
3.  Click either “Create link” or “Get embed” depending on how you want to share your block.
4.  The link or embed snippet will be copied to your clipboard.

Note

If you experience any issues with block sharing, please see our known issues for [troubleshooting steps](/support-and-community/troubleshooting-and-support/known-issues/#online-features-dont-work).

## Permalink

Create and share a permalink to your blocks to collaborate with teammates. Here is the [web permalink](https://app.warp.dev/block/vzFATak939iqGWfNh7wsAP) of the block depicted below.

![Shared Block](/_astro/shared_block.D2IReJPD_Z1Qe5lH.webp?dpl=dpl_9gV68dirrqKrRdyth6yAi1FwZf77)

## Embedded blocks

Create and embed your blocks on web pages to help your readers follow along with technical writing. Readers can interact with an embedded block as they would with a block in Warp, with a context menu and styling. When you click “Get embed”, Warp will copy an `iframe` to your clipboard. Here’s an example `iframe`:

```
<iframe src="https://app.warp.dev/block/embed/qn0g1CqQnkYjEafPH5HCVT"title="server script error" style="width: 712px; height: 397px; border:0;overflow:hidden;" allow="clipboard-read; clipboard-write"></iframe>
```

#### Embedded block example on web page

![Embedded Block Example](/_astro/embed.Bsc43pKr_Z2isyMy.webp?dpl=dpl_9gV68dirrqKrRdyth6yAi1FwZf77)

## Managing shared blocks

You can unshare a block by navigating to **Settings** > **Shared blocks**. Currently, shared blocks are accessible to anyone with the link.

## Link previews

Shared permalinks will also display a preview of your code for quick context on each link.

Note

Compatible with any platform that supports Open Graph or Twitter meta tags. For example, Slack, Twitter, Facebook, Telegram, Notion, and more.