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

# Media embeds

> Add supported media embeds to Pages content.

<Info>
  This doc only refers to embeds that are used in the beta Pages feature found in backstage and not in event descriptions.

  Full support is planned in a future update 🤓
</Info>

## Adding media embeds

We have optimised the editor to detect media links that can be embedded without needing to paste in html snippets.

This means you can paste in a valid link, and the content preview will appear in the editor.

Unsupported links will just be pasted as links.

Currently, we support:

* YouTube
* Spotify
* Bandcamp

And plan future support for:

* SoundCloud
* Instagram
* Twitter (X)

If you need a different type of embed, please get in touch, and we will do our best to help.

For specific implementation notes, please see below.

## YouTube

The easiest way to get a YouTube embed is to copy and paste the URL from the browser.

Supported link formats, with examples:

* Standard link: [https://www.youtube.com/watch?v=OqLgMiUj9NU](https://www.youtube.com/watch?v=OqLgMiUj9NU)
* Shortened link: [https://www.youtube.com/embed/OqLgMiUj9NU](https://www.youtube.com/embed/OqLgMiUj9NU)
* Shareable link: [https://youtu.be/OqLgMiUj9NU?feature=shared](https://youtu.be/OqLgMiUj9NU?feature=shared)

## Spotify

To share a Spotify player, we need the unique shareable Spotify link - NOT the embed option.

The link should look something like this: [https://open.spotify.com/album/3zMMu5oaIJjtjbfIAG56fZ](https://open.spotify.com/album/3zMMu5oaIJjtjbfIAG56fZ)

Supported link formats, with examples:

* Artist: [https://open.spotify.com/artist/2URLOBmWyIpqTD0dUOeFdp](https://open.spotify.com/artist/2URLOBmWyIpqTD0dUOeFdp)
* Track: [https://open.spotify.com/track/37vtnxtl0AQcPcB66BMWpq](https://open.spotify.com/track/37vtnxtl0AQcPcB66BMWpq)
* Album: [https://open.spotify.com/album/7vofK44MfpRJDptgSlsvR3](https://open.spotify.com/album/7vofK44MfpRJDptgSlsvR3)
* Playlist: [https://open.spotify.com/playlist/37i9dQZF1E4A63Fg5d8AXo?si=9d389ce0fbd84ecb](https://open.spotify.com/playlist/37i9dQZF1E4A63Fg5d8AXo?si=9d389ce0fbd84ecb)

Embed customisations (colour, etc) are not currently supported.

## Bandcamp

Embeds from Bandcamp are a little tricky, but we have created a workaround using the shareable WordPress codes.

To find the correct code, please follow these steps.

Find the track or album you want to embed

* Click on the share/embed button and select standard player with small artwork

* Under embed code, choose wordpress.com

* Copy and paste the shortcode - it should look something like this:

  `[bandcamp width=100% height=120 track=467870541 size=large bgcol=ffffff linkcol=0687f5 tracklist=false artwork=small]`

### Supported link formats, with examples:

* Track: `[bandcamp width=100% height=120 track=467870541 size=large bgcol=ffffff linkcol=0687f5 tracklist=false artwork=small]`
* Album: `[bandcamp width=100% height=120 album=2776732073 size=large - bgcol=ffffff linkcol=0687f5 tracklist=false artwork=small]`

Embed customisations (colour etc) are not currently supported.