PowerPress Playlist Shortcode

The Blubrry PowerPress Playlist shortcode is a playlist shortcode based on the WordPress playlist shortcode designed specifically for podcasting. Styling and functionality is the same, though shortcode options are different.


The PowerPress Playlist shortcode is available in PowerPress 6.0 and newer.

Note: The short code must be entered in lowercase.

PowerPress Playlist Shortcode Attributes

The Blubrry PowerPress short code supports many optional attributes for customizing the playlist.

  • limit - Set limit to number of episodes in playlist (default is 10)
  • type – Specify the type of play list either ‘audio’ (default) or ‘video’
  • style – Specify the playlist style ‘light (default), ‘dark’, or custom
  • images - Display podcast artwork in playlist ‘true’ (default) or ‘false’
  • image – Set a specific default image for the playlist (.e.g. http://example.com/path/to/image.png)
  • itunes_subtitle – Display the itunes subtitle in the player ‘true’ or ‘false’ (default)
  • category - Specify a category, value can be either the category ID, slug, or name (ID is optimal)
  • term_id – Specify a specific term ID (requires taxonomy attribute)
  • taxonomy - Specify a taxonomy (requires term_id attribute)
  • program_titles_by_taxonomy - Specify taxonomy to display program title in playlist (e.g. ‘category’ to display category program titles)
  • date - Display episode date ‘true’ (default) or ‘false’
  • title - Display episode (post) title, ‘true’ (default) or ‘false’
  • links - Provide links to episode (post) page, ‘true’ (default) or ‘false’
  • slug - Specify the channel/feed post type slug name for custom podcast channels or custom podcast post types
  • post_type - Specify post type for custom post type podcasting

Simple Example using playlist to display latest 10 audio episodes in a page


Display a player for a media file not associated to your podcast episode:

[powerpress url="http://example.com/path/to/media.mp3"]

Example playlist using specific poster image showing the latest 20 episodes

[powerpressplaylist image="http://example.com/wp-content/uploads/300x300.png" limit=20]

Example playlist for custom podcast channel using slug ‘audio-m4a’

[powerpressplaylist slug="audio-m4a"]

and if you are using post type podcasting:

[powerpressplaylist post_type="post_type_slug" slug="audio-m4a"]

Example displaying titles of podcasts based on category (or other taxonomy)

[powerpressplaylist program_titles_by_taxonomy="category"]

Include the iTunes subtitle for the currently playing episode in playlist

[powerpressplaylist itunes_subtitle=true]