> 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/submit-to-spotify.md).

# Submit to Spotify

Submit your podcast to Spotify, link an existing listing, deliver video episodes, or remove the podcast.

Use this task to list your podcast on Spotify. Podigee sends your feed to Spotify, waits until Spotify lists the podcast, and then informs the podcast owner by email.

## Before you start

* You need the owner, admin, or editor role for the podcast, with permission to edit the podcast.
* Automated submission needs a paid plan on the account of the podcast owner. The free Launch plan does not include it.
* The podcast must be published and must not be restricted to invited listeners.
* At least one episode must be published and publicly available.
* The podcast needs a cover image and a description.

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

### Submit the podcast

1. Open the podcast and select the **Exports** tab.
2. In the **Audio** section, select the **Spotify** tile.
3. Select **Submit**.

Podigee sends the podcast title and the MP3 feed URL to Spotify. The tile shows **Pending**. Podigee checks at regular intervals whether Spotify lists the podcast. When the podcast is available, the tile shows **Published**, and the podcast owner receives the email **The podcast "\[podcast title]" has been published on Spotify** with the button **Go to Spotify**.

The tile shows a warning when the podcast has no author name. Add the author in the podcast details before you submit.

### Link a podcast that is already on Spotify

1. Open the **Spotify** tile.
2. Select **If your podcast is already on Spotify, click here**.
3. Enter the podcast link in **Spotify URL**. The link has the form `https://open.spotify.com/show/<22 characters>`.
4. Select **Save**.

### Remove the podcast from Spotify

1. Open the **Spotify** tile of a published connection.
2. Select **Remove this podcast from Spotify**.

Podigee asks Spotify to remove the feed and clears the connection.

### Expected result

The **Spotify** tile shows **Published**. The web player and the podcast website can show a Spotify button.

### If you cannot complete the task

* The tile shows a lock icon: the account of the podcast owner is on a plan without automated submissions.
* **Submit** is disabled: add the cover image and the description, and publish one episode.
* The status stays **Pending**: Spotify did not list the podcast yet. Podigee continues to check. Do not submit again.
  {% endtab %}

{% tab title="Podigee workspace" %}
In the Podigee workspace, you manage Spotify on the **Spotify** page of **Reach**. The **Setup** card of the page has two tabs:

* **Audio**: Podigee sends your RSS feed to Spotify. Spotify gets new episodes from the feed.
* **Video**: Podigee delivers your audio and video episodes directly to Spotify. This direct delivery replaces the RSS feed for the Spotify listing.

A show uses one of the two tabs at a time. While Spotify gets the show through direct delivery, the **Audio** tab has no steps. It shows "Spotify uses direct delivery for this show" and the button **Open the Video tab**.

Each control needs two permissions: to edit the podcast, and to change where the podcast is distributed. Contributors do not have the second permission. Without these permissions, the page shows "You can see where this show is published. Setting up channels needs permission to edit this show." Podigee checks the plan of the podcast owner, not the plan of the person who selects a control.

### Open the Spotify page

1. Open the podcast.
2. In the sidebar, under **Publish**, select **Reach**. **Reach** opens on **Channels**, on the tab **All**.
3. Find the **Spotify** row. The row is also on the tab **Set up from here**.
4. Select the **Spotify** row.

The Spotify page opens. Each tab of the **Setup** card shows its steps in sequence, with a status for each step. To see what a step needs, open the step.

The **Spotify** row and the header of the Spotify page show a pill for each version, for example **Audio** with **In review**. When the video version is set up, only the **Video** pill shows.

* **Not set up**: the version is not set up.
* **Needs a public feed**: the feed of the show is private. Spotify lists only shows with a public feed.
* **In review**: Podigee sent the feed. Spotify did not list the show yet.
* **Connected**: Spotify lists the show, you saved the link of the show, or direct delivery is on.
* **Not accepted**: Spotify refused the feed.
* **In progress**: Podigee sets up or checks the direct delivery, or the show goes back to its RSS feed.
* **Paused**: direct delivery is stopped. Spotify still manages the show through direct delivery.
* **Needs attention**: a setup started and a step needs you, or the direct delivery failed.
* **Paid plans**: the plan of the podcast owner does not include submissions to platforms.
* **Set up**: you set up Spotify before the first episode. Nothing was sent to Spotify.

### Send the audio feed to Spotify

1. On the Spotify page, select **Audio**.
2. Make sure that these steps show as done: **Your show is public**, **Your show details are complete**, and **Your plan includes this channel**. If a step is not done, open it and do what it says.
3. Open the step **Send your feed to Spotify**.
4. Read the sentence "Submitting your show accepts Spotify's platform terms." To read the terms, select **Read Spotify's terms**.
5. Under **Send it from here**, select **Send to Spotify**.

The step **Your show details are complete** names the missing items, for example "Before you send this show to Spotify: publish an episode, add a cover image, and add a show description." Select **Edit show details** to correct them. When the show has no author, the step also shows "Add an author in your show settings. Spotify uses this name in your listing."

While an item is missing, the step **Send your feed to Spotify** shows "Your show is not ready for Spotify. Complete the steps above before you submit it." with the button **Complete setup**.

When the plan of the podcast owner does not include submissions to platforms, the step **Your plan includes this channel** shows "A paid plan sends your show to Spotify." The step then shows **View plans** or **Upgrade plan**, or it says that the account owner or an administrator can change the plan. In place of **Send to Spotify**, the step **Send your feed to Spotify** shows "You can still add the link to a listing you set up yourself."

Expected result:

* The header of the page shows "New episodes will go to Spotify." with the steps **Connected**, **In review**, and **Live on Spotify**.
* The **Audio** pill shows **In review**. The step **Spotify lists your show** shows "Spotify reviews your show. This can take a few days." The **Spotify** tile in the classic view shows **Pending**.
* When Spotify lists the show, the **Audio** pill shows **Connected**. The **Setup** card shows "Spotify for audio is set up." and "This show is on Spotify as an audio show, delivered through your RSS feed." The button **Open on Spotify** shows below the steps. The **Spotify** tile in the classic view shows **Published**.

![The Spotify page in the Podigee workspace with the Setup card on the Audio tab, three steps Done, and the open step Send your feed to Spotify with the button Send to Spotify and the link Read Spotify's terms](https://2032417310-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbqUKO6lljHGzkEAzliPI%2Fuploads%2Fgit-blob-2f006ce47176db9fe4cdeb6d2c004fdd7c08fb44%2Fdoc-distribution-005-spotify-page.png?alt=media)

The step Send your feed to Spotify has the button Send to Spotify and the link to the terms of Spotify.

### Prepare Spotify before the first episode

Before the first episode of the show is live, nothing can go to Spotify. In **Prepare destinations** of the first episode, you can select **Set up Spotify**.

Podigee saves your choice only. It does not send the show to Spotify, also when the plan includes submissions to platforms. The card shows "Spotify is set up. Nothing is sent to Spotify yet." Until the first episode is live, the **Spotify** row in **Reach** shows **Set up**.

After the first episode is live, **Reach** can show "Your first episode is live" and "You set up Spotify before you published. Send your show from the cards below. This lists your show from its feed." This notice shows only when all of these conditions are true:

* The plan of the podcast owner includes submissions to platforms.
* The feed of the show is public.
* You have permission to change where the show is distributed.
* The show is not on Spotify yet.

Send the audio feed as described in "Send the audio feed to Spotify" on this page. If the notice does not show, open the Spotify page and do the steps of the **Audio** tab. See also [Publish your podcast to directories](https://docs.podigee.com/documentation/create-and-publish/publishing-and-distribution/publish-your-podcast-to-directories.md).

### Link a show that is already on Spotify

1. On the Spotify page, select **Audio**.
2. Open the step **Send your feed to Spotify**.
3. In **Already on Spotify?**, paste the address of the show on Spotify, for example `https://open.spotify.com/show/...`. You can also enter the 22-character ID of the show.
4. Select **Save link**.

The link does not send anything to Spotify. The field **Already on Spotify?** does not show while the feed of the show is private.

Expected result: the page shows "Spotify link saved." The step shows the saved address in **Spotify link** with the button **Copy link**. The **Audio** pill shows **Connected**.

### Change the saved Spotify link

**Change Spotify link** shows only when Podigee has a valid Spotify show address for the show. While Spotify gets the show through direct delivery, the **Audio** tab has no steps. Then see "Manage the direct delivery" on this page.

1. On the Spotify page, select **Audio**.
2. Open the step **Send your feed to Spotify**.
3. Open **Change Spotify link**.
4. In **Spotify link**, correct the address.
5. Select **Save link**.

The change keeps the delivery status and the review status of the listing. Expected result: the page shows "Spotify link saved."

If the saved address is not a valid Spotify show address, the step does not show **Change Spotify link**. It shows the field **Already on Spotify?**. Paste the correct address there, then select **Save link**. If the page also shows **Remove link**, you can remove the old address first.

### Remove the link or the show

The controls are below the steps of the **Audio** tab. They show when Podigee has a Spotify link for the show. The buttons that you see depend on how the show got to Spotify:

* **Remove link** always shows. Podigee removes only its saved link. Nothing is sent to Spotify. The show and its episodes stay on Spotify.
* **Remove from Spotify** also shows when Podigee sent the show to Spotify. Podigee asks Spotify to remove the feed. It does not show for a link that you saved yourself.

1. On the Spotify page, select **Audio**.
2. Select **Remove link** or **Remove from Spotify**.
3. Read the dialog **Please confirm**:
   * For **Remove link**: "Remove the saved Spotify link from Podigee? Your show and episodes stay on Spotify."
   * For **Remove from Spotify**: "Remove this show from Spotify? Spotify deletes the feed and listeners there will no longer find it. To get back on, you send the show again."
4. In the dialog, select the button with the same label.

To stop, select **Cancel** in the dialog. Nothing changes.

Expected result:

* After **Remove link**, the page shows "Link removed. Your show is still on Spotify."
* After **Remove from Spotify**, the page shows "Your show was removed from Spotify."

### Deliver video episodes to Spotify

With direct delivery, Podigee sends new audio and video episodes to Spotify. Spotify does not read your RSS feed for this listing.

Before you start:

* Direct delivery must be available for the show. When it is not available, the step **Your account can use video** shows the way to a plan, or the setup shows "Spotify video delivery is not available for this show."
* The plan of the podcast owner includes video and submissions to platforms.
* The show is public and has at least one published episode. You can add a video recording later.
* The show settings are complete. When a setting is missing, the step **Your show details are complete** names it, for example "Complete your show settings: description."
* To go back from direct delivery to the RSS feed later, you usually must contact Podigee Support. See "Manage the direct delivery" on this page.

1. On the Spotify page, select **Video**.
2. Make sure that the steps **Your show is public** and **Your show details are complete** show as done.
3. Open the step **Your account can use video**. If it shows **Enable video features**, the account owner or an organization admin must do this step:
   1. Select the checkbox "I accept the Podigee Terms of Service and want to enable video features."
   2. Select **Enable video features**.
4. Make sure that the step **Your account can use video** shows as done.
5. Open the step **Set up Spotify video delivery**.
6. Under **Is this show already on Spotify?**, select **No, create a new Spotify listing** or **Yes, use my existing Spotify listing**.
7. For a new listing, under **Which episodes should go to the new Spotify listing?**, select **Only episodes published from now on** or **All published episodes, then new episodes**.
8. For an existing listing, paste the show link in **Link to your Spotify show**. Use the show link, not an episode link.
9. Select the consent checkbox. For a new listing, it says "I understand that this Spotify listing will use direct delivery from Podigee. It will not receive episodes through RSS."
10. Select **Set up Spotify video**.

When Podigee already has the Spotify link of the show, steps 6 to 8 show that link in place of the questions. The page then says "Your existing Spotify listing will move from RSS to Podigee's direct delivery. Its link, followers and listening history stay." The consent checkbox then says "I understand that Spotify will receive this show's audio and video directly from Podigee instead of RSS."

Expected result:

* The page shows "Spotify setup has started. You can leave this page while it runs." The **Video** pill shows **In progress**. While the page is open, it updates the status.
* When the setup is complete, the **Video** pill shows **Connected**. The **Setup** card shows "Spotify for video is set up." The step **Spotify receives your episodes** shows "New audio and video episodes go to this Spotify show through Podigee."

### Manage the direct delivery

The controls are below the steps of the **Video** tab.

To go back from direct delivery to the RSS feed, contact Podigee Support with your feed address. Stopping the delivery does not bring back the RSS feed. In most cases, the page does not show **Return to RSS feed**.

* **Resync with Spotify**: Podigee checks the listing and its episodes in the background. This button shows while the delivery is on. After you select it, the button does not show until the check is complete. Wait for the result.
* **Stop delivery to Spotify**: the dialog says "Stop delivery to Spotify? New audio and video episodes will not be sent. Existing episodes stay. Audio does not return to RSS automatically." After you confirm, the **Video** pill shows **Paused**.
* **Return to RSS feed**: this button shows only when all of these conditions are true: you stopped the delivery, Spotify still has the show, the feed uses its Podigee address, and Podigee offers the button for your account. Spotify then gets the audio from your feed again. The dialog says "Return this Spotify show to your RSS feed? Spotify will receive audio from the feed again. Video delivery will stop."
* **Open on Spotify**: opens the listing on Spotify.

Direct delivery and **Paused** are two different states:

* While the direct delivery is on, new audio and video episodes go to Spotify through Podigee.
* While the delivery is paused, the step shows "Delivery to Spotify is paused. Existing episodes stay on Spotify. New audio and video episodes are not sent." Spotify still manages the show through direct delivery.

In both states, Podigee does not send your audio feed to Spotify, and you cannot change the saved audio link. To use the RSS feed again, contact Podigee Support with your feed address. The step then says "Resume delivery above. To return this show to RSS, contact support with your feed address." Only when the page shows **Return to RSS feed**, you can use that button.

### Resume a paused delivery

1. On the Spotify page, select **Video**.
2. Open the step **Set up Spotify video delivery**. It shows "Your Spotify listing is still saved. Resume delivery to use the same listing again."
3. Select **Resume Spotify delivery**.
4. If the page asks which episodes to send, select **Send the missing video episodes and future episodes** or **Send only future episodes**. Then select **Resume Spotify delivery** again.

If Spotify cannot find the listing, the page shows "Spotify could not find the previous listing. A new listing must be created to continue." Select which episodes to send. Then select **Create a new Spotify listing** and confirm the dialog. The new listing has a new link. Its followers do not move from the previous listing.

Expected result: the page shows "Spotify setup has started. You can leave this page while it runs." or "Spotify delivery is on again. New episodes will follow automatically." The **Video** pill shows **In progress**, then **Connected**.

### If you cannot complete the task

For the audio feed, Podigee shows most problems as a notice at the top of the page. A problem with the submission of the feed shows in the step **Send your feed to Spotify**, under **Why it stopped**.

* The **Spotify** row shows **Paid plans**, or the step **Your plan includes this channel** is not done: the plan does not include submissions to platforms. Select **View plans** or **Upgrade plan**, or ask the account owner. You can still link a show that is already on Spotify.
* "Before you send this show to Spotify: ...": do the items that the notice names. Then select **Send to Spotify** again.
* "Your plan does not include sending shows to platforms.": ask the account owner to change the plan.
* "Spotify lists only shows with a public feed, and this show's feed is private.": make the show public in its settings. Then send it again.
* "Spotify did not accept the feed. Please try again in a few minutes.": wait some minutes, then select **Send to Spotify** again.
* The **Audio** pill shows **Not accepted**, and the step shows **Try again**: Spotify refused the feed. Read the reason under **Why it stopped**. Select **Try again** only after you correct the cause.
* "Spotify already has this feed...": save the link of the show in **Already on Spotify?**. Do not send the feed again.
* "Spotify does not accept feeds from this show's web address...": contact Podigee Support.
* "Spotify must accept the domain of your feed...": this hint shows for a show with a custom domain. If Spotify refuses the domain, contact Podigee Support.
* "This show delivers video to Spotify, so its audio feed is not sent separately.": Spotify gets the show through direct delivery. Use the **Video** tab.
* "Spotify still manages this show through direct delivery, which is paused...": resume the delivery on the **Video** tab. To use the RSS feed again, contact Podigee Support.
* "This show uses Spotify direct delivery...": to change the audio link, contact Podigee Support first. Support returns the show to the RSS feed.
* "Enter your Spotify show address, or its 22 character ID.": correct the address, then select **Save link** again.
* "Spotify is not available for this show right now.": contact Podigee Support.
* "There is no Spotify listing on this show to remove.": reload the page to see the current status.
* "We could not confirm the removal with Spotify. Your listing is unchanged. Please try again in a few minutes.": wait some minutes, then remove the show again.
* "Video delivery to Spotify is on for this show. Stop video delivery before you remove the show from Spotify.": Podigee cannot remove the show while it delivers video to Spotify.
* "You do not have permission to change where this show is listed.": ask a person who can edit the podcast.
* The **Audio** pill stays at **In review**: Spotify did not list the show yet. Podigee continues to check. Do not send the feed again.

For the direct delivery, most problems show in the step that caused them.

* "Spotify could not finish this setup...": correct the steps that are not done, then set up the delivery again. If the problem continues, contact Podigee Support.
* "Spotify setup is still unfinished after 30 minutes...": select **Check again**. This does not start the setup again.
* "We could not refresh the Spotify status. Check again in a moment.": select **Check again**.
* "Ask your account owner or organization admin to enable video features. Then you can set up Spotify video here.": ask the account owner or an organization admin to do the step **Your account can use video**.
* "Your plan does not include Spotify video delivery. Check the plan step above.": the plan of the podcast owner does not include video. Ask the account owner to change the plan.
* "Spotify video delivery is not available for this show.": contact Podigee Support.
* "Enter a Spotify show link, such as <https://open.spotify.com/show/> followed by its 22-character ID.": correct the link, then select **Set up Spotify video** again.
* "A Spotify operation is already running. Wait for its result before you start another one.": wait until the **Video** pill no longer shows **In progress**.
* "Stop Spotify delivery first. Returning to RSS is available only...": contact Podigee Support with your feed address.
* "We could not complete this Spotify action. Please try again in a few minutes.": wait some minutes, then try again.
* "Only the show owner or an editor can change where this show is distributed. Ask the show owner to set it up.": ask the podcast owner.
  {% endtab %}
  {% endtabs %}

## Next step

[Submit to Deezer, Listen Notes, and Amazon Music](https://docs.podigee.com/documentation/create-and-publish/publishing-and-distribution/submit-to-deezer-listen-notes-and-amazon.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/submit-to-spotify.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.
