> For the complete documentation index, see [llms.txt](https://docs.podigee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podigee.com/documentation/create-and-publish/publishing-and-distribution/embed-the-player-on-your-website.md).

# Embed the player on your website

Copy the embed code for your podcast or one episode, and use the oEmbed endpoint for automatic embeds.

Use this task to put the Podigee web player on your own website. You can embed the whole podcast, one episode, a playlist, or a subscribe button. Websites and platforms that support oEmbed (the open standard to embed content from a URL) can embed an episode from its URL without a code snippet.

## Before you start

* You need the owner, admin, or editor role for the podcast, with permission to edit the podcast.
* The episode that you embed must be published. The public embed of an unpublished episode does not render for visitors.
* You need edit access to the website that receives the code.

{% tabs %}
{% tab title="Classic view" %}

### Embed the podcast player

1. Open the podcast and select the **Web player** tab.
2. Copy the embed code. The tab offers a script tag that loads the player with your configuration. The tab also offers a simple iframe with a width of 100% and a height of 100 pixels.
3. Paste the code into the HTML of your website.

![Web player tab in the podcast settings of the classic view, shown for a podcast without a published episode](https://2032417310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbqUKO6lljHGzkEAzliPI%2Fuploads%2Fgit-blob-01d16834b69a1da4d0002738d7b03b85855077cd%2Fdoc-distribution-011-classic-web-player-tab.png?alt=media)

The Web player tab holds the embed code once the podcast has a published episode with audio.

### Embed one episode

1. Open the episode and select the media tab.
2. Under **Embed web player**, copy the code from **HTML code for your website**.
3. When needed, switch between **Use simple embed** and **Use advanced embed**. The advanced embed uses the player script. The simple embed uses an iframe.
4. Paste the code into the HTML of your website.

### Embed a playlist or a subscribe button

The podcast site also serves a playlist embed and a subscribe button embed. The playlist uses the player configuration of the podcast. You can switch off the playlist per context in the web player settings.

### Expected result

The player shows on your website with the style, colors, and extensions from the web player settings. The embedded context uses the settings for embeds, not the settings for the podcast website.

### Restricted podcasts

When the podcast is restricted to invited listeners, the embedded player asks the visitor to sign in as a listener before it plays.

### oEmbed reference

Use this reference when a content management system or a platform asks for oEmbed support.

| Item                | Value                                                                                                         |
| ------------------- | ------------------------------------------------------------------------------------------------------------- |
| Endpoint            | `/oembed` on the Podigee embed host, with the parameter `url` set to the episode page                         |
| Formats             | JSON only. A request for XML answers 501                                                                      |
| Response type       | `rich`, oEmbed version `1.0`, provider `Podigee`                                                              |
| Response fields     | `html` with the embed code, `width` 100%, `height`, `title`, `description`, `thumbnail`                       |
| Height              | 142 for the default theme, 50 for the minimal theme, or the height set in the web player                      |
| Optional parameters | `type`, and `context` with `website` or `external`                                                            |
| Episode resolution  | By the episode URL, by the podcast URL for the latest published episode, or by the external URL of an episode |
| Unknown URL         | 404                                                                                                           |
| Cookies             | None                                                                                                          |

The same host serves a player card for X at `/twitter` with the parameter `url`.

### Playlist embed parameters

| Parameter   | Value                                                                                  |
| ----------- | -------------------------------------------------------------------------------------- |
| `page_size` | 1 to 50 episodes per page. 1 when the parameter is missing. Values above 50 answer 422 |
| `offset`    | Number of episodes to skip                                                             |

### If you cannot complete the task

* The player is empty on your website: check that the episode is published and that you pasted the code without changes.
* The oEmbed request answers 404: use the URL of a published episode page.
  {% endtab %}

{% tab title="Podigee workspace" %}
In the Podigee workspace you copy the embed code of the show in the **Embed** card of the Player settings. You copy the embed code of one episode in the **Embed this episode** card of the episode page. The code is the player script. When the show uses the simple player, the code is an iframe with a height of 100 pixels. The workspace has no switch between the script and the iframe, no start time, no live preview, and no playlist or subscribe button embed. Use the classic view for these parts of the task.

### Complete the task

1. Open the podcast and select **Settings** under **Publish** in the sidebar. Select **Player**. The page **Edit player settings.** opens.
2. Go to the card **Embed the player on your website**, below **Theme and branding**.
3. Read the hint below **Embed code**. "Player script. Paste it where the player should appear." tells you that the code is the player script. "Simple player, 100 pixels high. Paste it where the player should appear." tells you that the code is an iframe.
4. Select **Copy code**. The button shows **Code copied** for a short time.
5. To get the code of one episode, select **Episodes** in the sidebar. Open the published episode.
6. Go to the card **Embed this episode**, below **Preview the episode**.
7. Select **Copy code**.
8. Paste the code into the HTML of your website, at the position where the player must appear.

![Player settings page of the Podigee workspace with the Embed the player on your website card, the player script under Embed code, and the Copy code button](https://2032417310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbqUKO6lljHGzkEAzliPI%2Fuploads%2Fgit-blob-97a69cd7a2ff2a4f9fcdd016c0ffc410dd663d68%2Fdoc-distribution-011-player-embed-card.png?alt=media)

The Embed card of the Player settings holds the code for the complete show.

![Episode page of the Podigee workspace with the Embed this episode card below the episode preview, the embed code, and the Copy code button](https://2032417310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbqUKO6lljHGzkEAzliPI%2Fuploads%2Fgit-blob-4338b601fd2416f33102f918fb0443cef32e8e49%2Fdoc-distribution-011-episode-embed-card.png?alt=media)

The Embed this episode card holds the code for one published episode.

You can also open the Embed card from **Publish** > **Reach** > **Website** with the link **Get the player embed code**.

### Expected result

* The code is on the clipboard, and you can paste it into your website.
* The player shows on your website with the colors and panels from the Player settings. The embedded player uses the settings under **Panels in embeds**.
* The code uses the Podigee address of the show, also when the show has a custom domain. When you change the Podigee address, copy the code again and replace the old code on your website.

### If you cannot complete the task

When Podigee cannot give an embed code, the card shows a notice with no code. The notice has the title **No embed code yet**, except for a private show. The text of the notice tells you the cause:

* "You can embed the player once the show is published.": publish the show first.
* "This show uses private access, so its player cannot be embedded on public websites.": the notice has the title **Not available for private shows**. The workspace gives no embed code for a show with private access.
* "You can embed the player once the show has a published episode.": publish an episode first. See [Schedule or change an episode publication](/documentation/create-and-publish/production/episodes/schedule-or-change-an-episode-publication.md).
* "You can embed this episode once it is published.": the episode is not published. Publish the episode first.
* "You can embed this episode once its audio has finished processing.": Podigee still processes the audio of the episode. Wait until the processing is complete, then open the episode page again.
* "This show has no Podigee website, so there is no player to embed.": the show has no Podigee website. The workspace gives no embed code for this show.
* "The embed code is not available right now. Try again later.": try again later.
* The episode page shows no **Embed this episode** card: the episode is a draft or it is scheduled. The card shows only for a published episode.
* The button shows "Copy failed. Select the code and copy it yourself.": select the code in the card and copy it with the keyboard or the context menu of your browser.
  {% endtab %}
  {% endtabs %}

## Next step

[Configure the web player](/documentation/create-and-publish/publishing-and-distribution/configure-the-web-player.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.podigee.com/documentation/create-and-publish/publishing-and-distribution/embed-the-player-on-your-website.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.