Skip to Content
Podcasting2.org’s content is now powered by Markdown and open for contributions!

Image

<podcast:image>

This tag allows for the delivering of images of various sizes and use cases. It is cross-compatible with the <itunes:image> tag but expands the use cases for delivering more than just square channel or episode art.

Parent

<channel> or <item> or <podcast:liveItem>

Count

Multiple

Attributes

  • href (required): The URL to the media you want to embed.
  • alt (recommended): A clear and concise accessibility focused text replacement for the image’s content.
  • aspect-ratio (recommended): A ratio value such as 1/1, 16/9, 4/1 following the equivalent CSS syntax. This allows podcasters to provide multiple art directions for the same media.
  • width (recommended): The width of the asset in pixels.
  • height (optional): The height of the asset in pixels.
  • type (optional): Mime type of the media such as image/jpeg or video/mp4.
  • purpose (optional): An unordered set of case-insensitive, space-separated tokens following the equivalent W3C syntax. This value should not exceed 128 characters. This allows podcasters to indicate the suggested uses of this media.

Notes

The only required attribute is href, specifying the url of the asset being delivered. If no further attributes are defined, such as aspect-ratio or purpose, the image is assumed to be square (1:1). For accessibility, alt is also encouraged.

The aspect-ratio and width are also encouraged, as they give app developers important information about how they can display your image within their UI. A height attribute is also available, but not critical if aspect-ratio and width are provided.

The type attribute is available for use if the asset being delivered is not a typical image format (JPG/PNG/etc). For instance, if it’s a video file, or something a-typical like a WEBP or TIFF image.

The purpose type is encouraged to provide an expected use case to app developers as a display hint. Why was this <podcast:image> included in the feed? What did the podcast creator intend to be done with it? Is a particular app or platform media asset being targeted? See a fuller explanation of the purpose attribute below.

Purpose Tokens

The purpose attribute gives podcasters the flexibility to indicate how specific images should be used by podcast apps and other platforms. This attribute accepts a space-separated list of tokens, where each token corresponds to a potential use case or context. While podcast apps may choose whether to honor these tokens, they allow podcasters to signal intent for how their images should be utilized across different platforms and contexts.

Anyone may define a token and its requirements. For instance, an app might define a token like truefans/hero to specify an image that fits their hero banner layout, providing guidelines for aspect ratios, resolution, safe areas, or text presence. A podcaster following these guidelines would include the truefans/hero token in the purpose attribute for any media following those guidelines. Here are some suggestions for generic tokens that multiple apps might adopt:

TokenGuidelinesPrior Art
artworkRecommended for representing the show/episode. Should contain your show name and key art.Apple’s show artwork
socialRecommended for social preview images. Should contain a landscape version of your artwork.Meta’s OG:image
canvasRecommended for immersive Now Playing screens. Should contain your artwork and expect to be overlaid with UI elements.Apple’s Full Page Show Art
Spotify’s Canvas
bannerRecommended for hero to complement your artworkYouTube’s channel banner
publisherRecommended for publisher logos. Should be legible at small sizes.Apple’s Channel Icon
circularRecommended for times when an image is expected to be cropped to a full circle. This should be a “circle safe” image.

Demo Tool

In addition to the examples below, a demo tool is provided to help get started with a few common image tag scenarios. The tool is provided by Nathan Gathright.

Examples

The most basic use cases

Standard square image. Assumed to be 1/1 aspect ratio intended for either podcast art or episode art, depending on if it’s in the <channel> or <item>.

<podcast:image href="https://example.com/images/pci_square-massive.jpg" />

Using alt to describe the image

<podcast:image alt="An antenna emanating signal waves" href="https://example.com/images/ep1/pci_square-massive.jpg" />

Using type to provide a video file

<podcast:image type="video/mp4" href="https://example.com/images/ep1/pci_square-massive.mp4" />

Using width and height instead of giving an aspect ratio

<podcast:image width="1200" height="400" href="https://example.com/images/ep1/pci_portrait.mp4" />

Using aspect-ratio

<podcast:image aspect-ratio="1/1" href="https://example.com/images/ep1/pci_square.jpg" /> <podcast:image aspect-ratio="16/9" href="https://example.com/images/ep1/pci_landscape.jpg" /> <podcast:image aspect-ratio="9/16" width="1200" href="https://example.com/images/ep1/pci_portrait.mp4" />

Using purpose

<podcast:image purpose="artwork" href="https://example.com/images/today_explained.jpg" /> <podcast:image purpose="publisher" href="https://example.com/images/vox_media.jpg" />

Using purpose to target a specific platform (ex. Apple)

<podcast:image purpose="apple/showcase-hero" href="https://example.com/images/today_explained.jpg" />

Using aspect-ratio and purpose to provide multiple art directions

Multiple image tags in the feed allow apps to select from multiple aspect ratios and media formats to display.

<podcast:image purpose="artwork" aspect-ratio="1/1" href="https://example.com/images/ep1/pci_square-massive.jpg" /> <podcast:image purpose="artwork social" aspect-ratio="16/9" href="https://example.com/images/ep1/pci_landscape-massive.jpg" />

More complex examples

<podcast:image alt="An antenna emanating signal waves" purpose="artwork" type="image/jpeg" aspect-ratio="1/1" href="https://example.com/images/ep1/pci_square-massive.jpg" /> <podcast:image alt="An antenna emanating signal waves" purpose="artwork social" type="image/jpeg" aspect-ratio="16/9" href="https://example.com/images/ep1/pci_landscape-massive.jpg" /> <podcast:image alt="An antenna emanating signal waves" purpose="artwork canvas" type="image/jpeg" aspect-ratio="9/16" href="https://example.com/images/ep1/pci_portrait-massive.jpg" /> <podcast:image alt="An antenna emanating signal waves" purpose="artwork" type="video/mp4" aspect-ratio="1/1" href="https://example.com/images/ep1/pci_square-massive.mp4" /> <podcast:image alt="An antenna emanating signal waves" purpose="artwork social" type="video/mp4" aspect-ratio="16/9" href="https://example.com/images/ep1/pci_landscape-massive.mp4" /> <podcast:image alt="An antenna emanating signal waves" purpose="artwork canvas" type="video/mp4" aspect-ratio="9/16" href="https://example.com/images/ep1/pci_portrait-massive.mp4" />

Credits

Feature support

Podcast apps

No support, yet.

Publishing/hosting tools

No support, yet.

Miscellaneous

No support, yet.