Skip to main content

[benecaster_platform_links]

Free

Renders “Listen on” platform badge links for a show — links to podcast platform listings (Apple Podcasts, Spotify, etc.). Distinct from benecaster_social_links (social media profiles) and benecaster_rss_link (direct RSS subscription). Platform URLs are entered once per show in Settings → Show → General → Platform Links. Platforms with no URL entered are silently omitted from the output.

Built-in platform slugs: apple_podcasts, spotify, overcast, pocket_casts, castro, podcast_addict, amazon_music, youtube_music. Custom slugs derive their label from the slug value.

The show’s own public feed is added as an rss link, labelled “RSS Feed”, at the end, so listeners whose app isn’t listed can still subscribe:

  • Your own rss link wins. If you entered an rss platform yourself (a feed host, or a measured redirect), it is used and no second one is added.
  • A show with no platforms set up shows this one link. Add rss="false" to show nothing instead.
  • It counts as a platform for the platforms attribute: platforms="rss" shows only the feed, and a list without rss leaves it out.

It isn’t added when the show has no public feed address. It keeps working when private delivery stops, because the public feed does.

Output filterable via benecaster_platform_links_output.

Show context: Without show_id, a show page or episode page supplies its own show, and anywhere else a single-show install uses its only show. On a multi-show install, show_id is required on any page that is not a show or episode page; the shortcode renders nothing if the show cannot be determined.

Parameters

Name Type Default Required Description
show_id int current show No Show to display platform links for. Defaults to the current show page or episode page's show, then the site's only show.
style string buttons No buttons — labelled button links; icons — icon-only (aria-label set from platform name); list — plain linked list.
platforms string (all configured) No Comma-separated platform slugs to include. Omit to show all configured platforms. The platforms attribute acts as a filter only, not an order specifier — display order follows the order entries appear in Settings → Show → General → Platform Links. The generated feed link's slug is rss.
rss string true No Whether to add the show's own public feed as an RSS Feed link. Set to false to show every configured platform without it.

Example

<!-- All configured platforms, default button style -->
[benecaster_platform_links]

<!-- Icon-only badges -->
[benecaster_platform_links style="icons"]

<!-- Apple Podcasts and Spotify only -->
[benecaster_platform_links platforms="apple_podcasts,spotify"]

<!-- Specific show, list style -->
[benecaster_platform_links show_id="2" style="list"]

Related Recipes