> 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 or one episode. 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

* In the classic view, you need the owner, admin, or editor role for the podcast, with permission to edit the podcast.
* In the Podigee workspace, you need access to the show to copy the code. To change the player settings, you need permission to edit the show.
* In the classic view, the episode that you embed must be published. In the Podigee workspace, you can copy the code of an episode before it is published.
* 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 code from **Embed code**. The code loads the player script with your configuration. If your website blocks scripts, for example on Wix, select **Use simple embed** under **Style** first. **Embed code** then shows an iframe with a fixed height.
3. Paste the code into the HTML of your website.

### Embed one episode

1. Open the episode and select the **Media Files** tab.
2. Find the section **Web player**. It shows a preview of the player for this episode.
3. Copy the code from **Embed code**. If your website blocks scripts, select **Use simple embed** below the code first. The code is then an iframe with a fixed height. **Use advanced embed** brings back the player script.
4. Paste the code into the HTML of your website.

### Show a playlist in the player

Podigee does not give a separate embed code for a playlist or a subscribe button. To show the episodes of the podcast in an embedded player, switch on **Playlist** under **Active extensions** in the section **Embedded** of the **Web player** tab. See [Configure the web player](https://docs.podigee.com/documentation/create-and-publish/publishing-and-distribution/configure-the-web-player.md).

### Expected result

The player shows on your website with the style, colors, and extensions from the web player settings. The embedded player uses the settings in the section **Embedded**, not the settings in the section **On 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.

### 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 **Web player** tab shows no embed code: the podcast has no published episode yet. Publish an episode first.
* The oEmbed request answers 404: check that `url` contains an episode page address or the episode's external URL. A valid URL also answers 404 for a draft or scheduled episode, an unpublished show, or a show with private access. If the episode is a draft or scheduled, publish it. If the show is unpublished, publish it. For a private show, use a code from the classic view if one is available.
  {% endtab %}

{% tab title="Podigee workspace" %}
In the Podigee workspace, you copy the embed code of the show in the card **Embed the player on your website** on the player settings page. You copy the embed code of one episode in the **Share** tab of the **Episode Management** card on the episode page. Both give the player script, and an iframe code for websites that block scripts. The player settings page also shows a live preview with a sample episode.

Every episode has its embed code, also a draft, a scheduled episode, and an episode whose audio Podigee still processes. Episodes of an unpublished show and of a show with private access also have their code. You can put the code on your website before the release. Only a show without a Podigee website has no embed code.

### Embed the show player

1. Open the podcast and select **Reach** under **Publish** in the sidebar. The page **Reach** opens.
2. Select the card **Player**. The card **Your player** shows the player settings.
3. Go to the card **Embed the player on your website**.
4. Keep **Script** selected next to "Paste it where the player should appear." If your website blocks scripts, for example on Wix, select **iFrame**. Next to **Copy code**, the card then shows "iFrame with a fixed height. Use it only if your website blocks scripts."
5. Select **Copy code**. The button shows **Code copied** for a short time.
6. Paste the code into the HTML of your website, at the position where the player must appear.

On the page **Reach**, the card **Website** also opens the card **Embed the player on your website**. It is next to **Analytics**. When you cannot edit the website, or when the website forwards visitors to your own website, the card is below the address.

### Embed one episode

1. Select **Episodes** in the sidebar. Open the episode.
2. Go to the **Episode Management** card. The **Share** tab is the first tab, and it opens first.
3. Below the **Episode URL**, find the **Embed code**. Keep **Script** selected next to "Paste it where the player should appear." If your website blocks scripts, select **iFrame**. The tab then shows "iFrame with a fixed height. Use it only if your website blocks scripts."
4. Select **Copy code**. The button shows **Code copied** for a short time.
5. Paste the code into the HTML of your website, at the position where the player must appear.

The **Share** tab also shows the **Episode URL** in a read-only field. The line below the label reads "Share it anywhere. It opens the episode page on your podcast website." Select **Copy URL** to copy the address. Before the publication, the hint "The address changes if you change the episode number, season or type." shows below the field. The **Share Episode URL** button in the **Publishing** card copies the same address.

Below the script code, the **Share** tab shows "If you change the show's Podigee address, paste the code again." The code of a draft, a scheduled episode or an episode of an unpublished show plays once the episode is published. You do not need to copy the code again after the publication.

### 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 player of an episode that is not public yet starts to play the episode when it is published.
* 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 the notice **No embed code yet** with no code. The text of the notice tells you the cause:

* "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 or its episodes.
* "You can embed the player once the show is published.": this notice is only on the player settings page. Publish the show first, or copy the code of one episode.
* "You can embed the player once the show has a published episode.": this notice is only on the player settings page. Publish an episode first, or copy the code of one episode. See [Schedule or change an episode publication](https://docs.podigee.com/documentation/create-and-publish/production/episodes/schedule-or-change-an-episode-publication.md).
* "The embed code is not available right now. Try again later.": try again later.

Other problems:

* The button shows **Not copied**: select the code in the card. Copy it with the keyboard or the context menu of your browser.
* The player settings page shows "Only people who may edit this show can change these settings.": you can copy the embed code, but you cannot change the player settings. Ask a person who can edit the show.
  {% endtab %}
  {% endtabs %}

## Existing Simple embeds

Existing Simple iframes now show the new player. Audio playback needs no code changes. In an iframe lower than 220 pixels, the player shows one slim row with the main controls and a link to the episode page. For a video episode, a button in this row opens the video in full screen when the iframe permits it.

For video in full screen, add `allowfullscreen` to the iframe tag if `allow` has no `fullscreen` directive. Bare `allow="fullscreen"` does not cover the redirect to the player address. A `fullscreen` directive overrides `allowfullscreen`. If that directive blocks the player address, remove only that directive and add `allowfullscreen`, or replace the iframe with the script embed. Keep other `allow` permissions. If the browser rejects full screen, the player returns to audio.

Iframes with your own CSS, your own HTML, or a customer theme keep their player. Both interfaces give the script embed for new placements, and an iframe code for websites that block scripts.

## Reference for developers

The API Reference documents the embed codes, the URL parameters, the playlist parameters, and oEmbed:

* [Embed codes and configuration URLs](https://docs.podigee.com/api-reference/web-player/embed-codes-and-configuration-urls)
* [oEmbed](https://docs.podigee.com/api-reference/web-player/oembed)
* [Player JavaScript API](https://docs.podigee.com/api-reference/web-player/javascript-api)

## Next step

[Configure the web player](https://docs.podigee.com/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
