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

# Sharing & Embeds

> Share BeatPass content with direct links and embed supported players on external sites.

BeatPass lets you copy share links for major content types and embed players for tracks and albums on external sites.

***

## What You Can Share

| Content type      | Share link | Embed code |
| ----------------- | ---------- | ---------- |
| **Track**         | Yes        | Yes        |
| **Album**         | Yes        | Yes        |
| **Producer page** | Yes        | No         |
| **Playlist**      | Yes        | No         |

***

## Using the Share Dialog

<Steps>
  <Step title="Open Share">
    Use the visible **Share** action on the page, or open the content's **More** menu and choose **Share**.
  </Step>

  <Step title="Copy the direct link">
    The dialog shows the canonical link for that item. Click **Copy** to place it on your clipboard.
  </Step>

  <Step title="Use native share when available">
    On supported browsers and devices, click **Share via…** to hand the link off to your device's native share sheet.
  </Step>
</Steps>

<Tip>
  Native share support depends on the browser and device. If it is not available, the copy-link flow still works.
</Tip>

<Note>
  The share dialog shows a **copy link** field and a **native share** button. Social platform buttons (Facebook, Twitter, Tumblr) are not part of the share dialog — they appear only on the upload success screen in Backstage.
</Note>

***

## Embedding Players

<Note>
  Embed functionality is available for **tracks** and **albums** only. Producer pages and playlists can be shared via link but cannot be embedded.
</Note>

<Steps>
  <Step title="Open the Share dialog">
    Click **Share** on any track or album page.
  </Step>

  <Step title="Switch to the Embed tab">
    Click the **Embed** tab in the share dialog.
  </Step>

  <Step title="Preview the embed">
    On desktop, the dialog shows a live preview of the embedded player.
  </Step>

  <Step title="Copy the code">
    Copy the generated `<iframe>` code and paste it into your site's HTML.
  </Step>
</Steps>

| Content Type | Default Height | Width             |
| ------------ | -------------- | ----------------- |
| **Track**    | 174 px         | 100% (responsive) |
| **Album**    | 384 px         | 100% (responsive) |

<Tip>
  The iframe uses a responsive width, so it adjusts to the container on your site.
</Tip>

***

## Where Embeds Work

Embeds work in any context that accepts raw iframe HTML:

* Custom websites and landing pages
* Blog posts with HTML blocks
* Portfolio pages

**Browser notes:**

* Some browsers require user interaction before playback starts (autoplay policy).
* Your site must allow external iframes and the embed origin in its Content Security Policy.
* HTTPS pages generally provide the best embed compatibility.

***

## Sharing vs. Reposting

| Feature              | Share                      | Repost                                       |
| -------------------- | -------------------------- | -------------------------------------------- |
| **Who sees it**      | Anyone with the link       | Visitors to your BeatPass profile            |
| **Where it appears** | External destinations      | Your **Reposts** tab                         |
| **Requires account** | No                         | Yes                                          |
| **Use case**         | Promote content externally | Make a public recommendation inside BeatPass |

Use **Share** to promote content outside BeatPass. Use **[Repost](/help/social-features/reposts)** to recommend content within the BeatPass community.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Embed isn't displaying">
    Check these common issues:

    * The iframe code was not pasted correctly.
    * Your site blocks external iframes.
    * Your site's Content Security Policy does not allow the embed origin.
  </Accordion>

  <Accordion title="Audio isn't playing in the embed">
    Browser autoplay rules may require the listener to press play manually. Also confirm the track or album is still available.
  </Accordion>

  <Accordion title="The share sheet didn't open on my device">
    Your browser or device may not support the native share API. Use **Copy** instead.
  </Accordion>
</AccordionGroup>

<Snippet file="sections/need-help.mdx" />