Apple Podcasts RSS tags
Apple Podcasts reads itunes:type, itunes:season, and itunes:episode from your RSS feed. You set them in Podhome. We write them into the public feed.
Those three tags decide how Apple lists the show. itunes:type says whether episodes are episodic or serial. itunes:season groups episodes into seasons. itunes:episode gives each episode its number. A fourth tag, itunes:episodeType, marks a normal episode, a trailer, or a bonus.
Apple explains the same tags in A Podcaster’s Guide to RSS. This page is how you set them in Podhome, and what the feed contains afterwards. To submit the show itself, use Distribution.
Where each tag comes from
| Tag | What Apple uses it for | Where you set it |
|---|---|---|
itunes:type |
Episodic or serial. This sets the order of the show. | Show settings, Show Type |
itunes:season |
The season number. Apple groups episodes that share a season. | Episode settings, Season Number |
itunes:episode |
The episode number. Apple uses it to order a serial show. | Episode settings, Episode Number |
itunes:episodeType |
Full, trailer, or bonus. | Episode settings, Episode Type |
Show type: itunes:type
itunes:type sits on the show, once, in the channel of the feed. Its value is episodic or serial.
Open show settings. When Content Type is Podcast, choose Show Type. The same choice is on the form when you create the show. Save Changes when you are done.
Episodic. Stand-alone episodes. Apple presents and recommends them newest to oldest, and shows the publish date. The feed uses
<itunes:type>episodic</itunes:type>. Season Number is on the episode form for Episodic with Seasons and for Serial.Episodic with Seasons. Stand-alone episodes grouped into seasons, still newest to oldest. The channel tag is still
episodic. The season grouping comes fromitunes:seasonon each episode. Season Number is on the episode form.Serial. A story, a course, or any show meant to be heard in order. Apple presents episodes oldest to newest and shows the episode numbers. Seasons are grouped, and the newest season is listed at the top of the Apple Podcasts page. The feed uses
<itunes:type>serial</itunes:type>. Apple expects anitunes:episodenumber on every episode of a serial show.
Audiobook, Course, and Music are saved as Serial. Show Type is on the page when Content Type is Podcast. Switching Content Type to one of those three writes itunes:type as serial.
Season and episode numbers
itunes:season and itunes:episode sit on each episode. Open the episode from Episodes. On Episode settings:
Episode Number becomes
itunes:episode. Use a whole number from 1 upward. Leave it empty and Podhome omits the tag. On a serial show, fill it in for every episode so Apple can list them in order.Season Number becomes
itunes:season. It is on the form when Show Type is Episodic with Seasons or Serial. Use 1 for the first season, 2 for the next, and so on. Leave it empty and Podhome omits the tag.
On an episodic show, episode numbers are optional. Apple lists that show newest first. Fill in Episode Number when you want the number stored on the episode and written to the feed.
Apple hides the season label while the feed contains only one season. The season numbers show up in Apple Podcasts when a second season is in the feed. Keep numbering from the first season anyway, so the grouping is already in the RSS.
In show settings you can turn on Automatically try to fill Episode and season number. A new episode then gets the next episode number. If an earlier episode already has a season number, the new one gets that season too. Change either number before you publish if this episode belongs somewhere else.
The same numbers are also written as podcast:season and podcast:episode for apps that follow Podcasting 2.0.
Episode type: itunes:episodeType
Episode Type is on the same episode form, under the numbers. Podhome writes itunes:episodeType for each published episode. The values in the feed are Full, Trailer, and Bonus, which are Apple’s full, trailer, and bonus types.
Normal Episode is a complete episode. The feed says
Full. This is the default, and it is the one that keeps an episode number.Bonus Episode is extra content, such as a behind-the-scenes conversation. The feed says
Bonus. Choosing it clears the episode number. Add a season number when the bonus belongs to a season.Trailer is a short preview. With no season number, the option reads Show Trailer. With a season number, it reads Season N Trailer. The feed says
Trailer, and the episode number is cleared. A trailer is also listed with the Podcasting 2.0 trailer tag, covered on the Podcasting 2.0 page.
Episode Type is on episode settings for a podcast, an audiobook, and a course. A music show is serial, so the track form includes Track Number and Season Number.
What the public feed contains
You edit the show and the episode. Podhome writes these Apple tags into the public RSS feed when that feed is updated. The channel tag is itunes:type. itunes:season, itunes:episode, and itunes:episodeType are written on each published episode.
A serial show in season 2, with episode 3 as a normal episode, carries these tags:
<itunes:type>serial</itunes:type>
<item>
<itunes:episode>3</itunes:episode>
<itunes:season>2</itunes:season>
<itunes:episodeType>Full</itunes:episodeType>
</item>
Episodic and Episodic with Seasons both use <itunes:type>episodic</itunes:type>. itunes:season is added on each episode that has a season number. itunes:episode is added when that episode has an episode number.
After you submit the feed to Apple Podcasts, Apple reads these tags from that same URL. Later edits in Podhome are picked up the next time Apple refreshes the feed.
Related guides
Distribution — submit the show to Apple Podcasts, Spotify, and other directories.
Podcasting 2.0 — the broader set of tags Podhome writes, including season, episode, and trailer.
A Podcaster’s Guide to RSS — Apple’s own description of
itunes:type,itunes:season,itunes:episode, anditunes:episodeType.