<<

NAME

Feed::Parser::NS::ITunes

DESCRIPTION

iTunes uses RSS 2.0 with some additional tags. When using the iTunes tags, you must add a namespace declaration in your feed xml, like this:

 <rss xmlns:itunes="http://www.itunes.com/DTDs/Podcast-1.0.dtd" version="2.0">

Please use UTF-8 encoding for your feed. Other encodings are not guaranteed to work in iTunes.

All values should be plain text (no markup or HTML). Values are limited to 255 characters, except for itunes:summary which can be up to 4000 characters. Whitespace in values is significant, i.e. it will show in iTunes, so don't add leading or trailing whitespace to your values.

NAMESPACE

xmlns:itunes="http://www.itunes.com/DTDs/Podcast-1.0.dtd"

ELEMENTS

itunes:author

The contents of this tag is shown in the Artist column in iTunes.

itunes:block

Use this inside an item element to prevent that episode from appearing in the iTunes Podcast directory. Use this inside a channel element to prevent the entire podcast from appearing in the iTunes Podcast directory.

itunes:category

When browsing Podcasts in the iTunes Music Store, Categories are shown in the 2nd column and Subcategories are shown in the 3rd column. Not all Categories have Subcategories.

Use a top level itunes:category to specify the browse category, and a nested itunes:category to specify the browse subcategory. Choose from the existing categories and subcategories on the iTunes Music Store.

If a nested itunes:category is specified, iTunes will show it in the Category column, otherwise iTunes will show the top level itunes:category in the Category column.

itunes:duration

The contents of this tag is shown in the Time column in iTunes.

The tag can be formatted HH:MM:SS, H:MM:SS, MM:SS, or M:SS (H = hours, M = minutes, S = seconds)

itunes:explicit

This tag should be used to indicate whether or not your podcast contains explicit material.

The two values for this tag are "yes" and "no".

If you populate this tag with "yes", a parental advisory graphic will appear next to your podcast artwork on the iTunes Music Store, and in the Name column in iTunes.

itunes:keywords

This tag allows users to search on text keywords.

Use spaces to separate keywords.

itunes:image

This tag specifies the artwork for your podcast. Put the url to the image in the href attribute.

iTunes prefers square images that are at least 300 x 300 pixels, which is different than what is specified for the standard RSS image tag. Hence we have a custom tag.

iTunes supports images in JPEG and PNG formats. The url must end in ".jpg" or ".png".

itunes:owner

This tag contains information that will be used to contact the owner of the podcast for communication specifically about their podcast. It will not be publicly displayed.

Put the email address of the owner in a nested itunes:email element.

Put the name of the owner in a nested itunes:name element.

itunes:subtitle

The contents of this tag is shown in the Description column in iTunes, as such it looks best if it is only a few words long.

itunes:summary

The contents of this tag is shown in a separate window that appears when the ⓘ (circled i) in the Description column is clicked. It also appears on the iTunes Music Store page for your podcast. This field can be up to 4000 characters.

SEE ALSO

Specified in: http://phobos.apple.com/static/iTunesRSS.html

COPYRIGHT

<<