An RSS feed contains all the metadata or “tags” about a podcast. Luminary uses the tags in the RSS feeds to display your podcast’s information in our app. Please see the table below for how we use RSS fields. If you have any questions, please email Luminary support at support@luminarypodcasts.com.
Podcast Tags (parent tag: <channel>)
|
Tag |
Description |
Example |
|
<title> |
Name of your podcast. |
<title>Name of your podcast</title> |
|
<itunes:author> |
Author of your podcast. If this is blank, we will display owner’s name (see field below). |
<itunes:author>Company or individual name</itunes:author> |
|
<itunes:owner> |
Email address and name of RSS field owner. If there is not an author field specified, we will display owner name instead. |
<itunes:owner> <itunes:email> youremailaddress@gmail.com </itunes:email> <itunes:name> Your name </itunes:name> </itunes:owner> |
|
<itunes:image>OR<image> |
Image shown to identify your podcast. If there is no <itunes:image>, will display <image> |
<itunes:image href="http://sample.com/podcasts/image.jpg"/> |
|
<content:encoded> OR <description> |
Description of your podcast. If the <content:encoded> tag isn’t included, <description> will be used instead. We support the following HTML tags within the expanded episode and show description views within the Luminary mobile apps: <p>, <ol>, <ul>, <li>, <a>. There are certain areas within the apps that we show a smaller view of your show and episode descriptions with limited space. In these views, we do not currently support HTML tags. However, those views are expandable by a user and will support HTML. |
<content:encoded> <![CDATA[ <a href="http://www.apple.com">Apple</a> ]]> </content:encoded> <description> Description of your podcast </description> |
|
<language> |
Language used in your podcast. Currently, this is used internally and is not displayed in the app. Language values from the ISO 639 list (two-letters, with some possible modifiers like "en-us") can be used. |
<language>fr</language> |
|
<itunes:explicit> |
Indicates if your podcast includes explicit content This tag can be a Yes or No value. Currently, this is used internally and not displayed in the app. |
<itunes:explicit>yes</itunes:explicit> |
|
<itunes:category> |
Specify a category and subcategory for your podcast. Luminary supports top level category and one sub level category. If more are listed, Luminary will use the first of each. See Apple’s guide to categories here. |
Single category: <itunes:category text="Music" /> Category with ampersand: <itunes:category text="TV & Film" /> Category with subcategory: <itunes:category text="Society & Culture"> <itunes:category text="History" /> </itunes:category> |
|
<itunes:type> |
Values can be one of the following:
|
<itunes:type>serial</itunes:type> |
|
<copyright> |
The show copyright details. Example: © 2019 Company Name, Inc. Support for displaying this field in the Luminary App is in progress. If you would like this information to be displayed immediately, we recommend including it in the <content:encoded> or <description> fields. |
<copyright>Copyright Information</copyright> |
|
<link> |
Link to an external page for your podcast. Support for displaying this field in the Luminary App is in progress. If you would like this link to be displayed immediately, we recommend including it in the <content:encoded> or <description> fields. |
<link>http://sample.com</link> |
|
<itunes:new-feed-url> |
The new podcast RSS Feed URL. If you change the URL of your podcast feed, you should use this tag in your old feed. Use the <itunes:new-feed-url> tag to manually change the URL where your podcast is located. You should maintain your old feed until you have migrated your existing subscribers. |
<itunes:new-feed-url>http://newlocation.com/example.rss </itunes:new-feed-url> |
Episode Tags (parent tag: <item>)
|
Tag |
Description |
Example |
|
<title> |
Title of the podcast episode |
<title>Episode Title</title> |
|
<enclosure> |
The episode content (url where the podcast is available), file size, and file type information. The <enclosure> tag has three attributes: URL, length, and type: URL: The URL attribute points to your podcast media file. The file extension specified within the URL attribute determines whether or not content appears in the podcast directory. Supported file formats include M4A, MP3, MOV, MP4, M4V, and PDF. Length: The length attribute is the file size in bytes. You can find this information in the properties of your podcast file (on a Mac, choose File > Get Info and refer to the size field). Type: The type attribute provides the correct category for the type of file you are using. The type values for the supported file formats are: audio/x-m4a, audio/mpeg, video/quicktime, video/mp4, video/x-m4v, and application/pdf. |
<enclosure url="http://www.examplesite.com/filename.mp3" length="123456" type="audio/x-mp3"/> |
|
<content:encoded> OR <description> |
Description of your podcast. If the <content:encoded> tag isn’t included, <description> will be used instead. We support the following HTML tags within the expanded episode and show description views within the Luminary mobile apps: <p>, <ol>, <ul>, <li>, <a>. There are certain areas within the apps that we show a smaller view of your show and episode descriptions with limited space. In these views, we do not currently support HTML tags. However, those views are expandable by a user and will support HTML. |
<content:encoded> <![CDATA[ <a href="http://www.apple.com">Apple</a> ]]> </content:encoded> <description> Description of your podcast </description> |
|
<pubDate> |
Publication date or the episode. If a <pubDate> tag isn’t included, the date the feed was accessed may be used instead. |
<pubDate>Wednesday, 04 Feb 2015 00:00:00 EST</pubDate> |
|
<itunes:duration> |
The duration of an episode in seconds or HH:MM:SS. |
<itunes:duration>01:73:35</itunes:duration> |
|
<itunes:explicit> |
Indicates if your podcast episode includes explicit content This tag can be a <Yes> or <No> value. Currently, this is used internally and not displayed in the app. |
<itunes:explicit>yes</itunes:explicit> |
|
<itunes:season> |
The episode season number. If an episode is within a season use this tag. Where season is a non-zero integer (1, 2, 3, etc.) representing your season number.
|
<itunes:season>2</itunes:season> |
|
<itunes:episode> |
An episode number. Please use a non-zero integer (1,2,3). |
<itunes:episode>5</itunes:episode> |
|
<itunes:episodeType> |
If an episode is a trailer or bonus content, use this tag. The episodeType value can be one of the following:
|
<itunes:episodeType>trailer</itunes:episodeType> |
|
<link> |
An episode link URL. Support for displaying this field in the Luminary App is in progress. If you would like this link to be displayed immediately, we recommend including it in the <content:encoded> or <description> fields. |
<link> http://www.mypodcast.com/episode-one.html </link> |
|
<itunes:image> OR <image> |
The episode artwork. If this is blank or not included, we will use show level artwork. If there is no <itunes:image>, will display <image> |
<image href="http://sample.com/podcasts/image.jpg"/> |