Skip to main content

Shortcodes Reference

Every shortcode Benecaster provides, then the ones each add-on adds. Each name links to its reference page with the full attribute list and examples.

A shortcode that belongs to one show takes its show from show_id if you set one, then from the page it sits on (a show page, or an episode page’s show), then from the site’s only show. On a multi-show site, set show_id on any page that is not a show or episode page. [benecaster_account], [benecaster_user_badge], [benecaster_member_since] and [benecaster_listener_support] treat a missing show_id differently, on purpose — see Running Multiple Shows.

Base Styles

Ten shortcodes load a small stylesheet of their own when they appear on a page: [benecaster_player], [benecaster_episodes], [benecaster_latest_episode], [benecaster_pricing_table], [benecaster_episode_nav], [benecaster_related_episodes], [benecaster_episode_share], [benecaster_social_links], [benecaster_platform_links] and [benecaster_rss_link]. It makes them look tidy on any theme without imposing a design — and because every rule has zero specificity, your theme’s CSS always wins, with no !important needed. The episode page and the episode archive load it too when they play a video or an embed, so the video fits its column.

The icon styles draw a real icon for every platform: [benecaster_social_links] (icons are its default), [benecaster_platform_links style="icons"], [benecaster_episode_share style="icons"] and [benecaster_rss_link]‘s icon and icon_link styles. A custom social link you added yourself gets a chain-link icon.

To turn the stylesheet off, tune it, or swap in your own icons, see Template Overrides → Styling the Shortcodes.


Episodes

Show your episodes and show details on any page: players, episode lists and cards, navigation between episodes, search, sharing and listen-on links.

Shortcode Description
[benecaster_episode_count] Displays the number of published episodes for a show.
[benecaster_episode_description] Outputs an episode’s short RSS description — the same field that maps to description and itunes:summary in the episode’s RSS feed item. Renders nothing for visitors when the episode isn’t published.
[benecaster_episode_link] Renders a styled inline link to another episode. Renders nothing for visitors when that episode isn’t published.
[benecaster_episode_nav] Renders previous and next episode navigation links for the current (or specified) episode.
[benecaster_episode_share] Renders social share buttons for an episode. Renders nothing for visitors when the episode isn’t published.
[benecaster_episodes] Renders an episode list or grid for a show.
[benecaster_explicit_badge] Shows the “Explicit” label for an episode, the same one Apple Podcasts and other apps display. Renders nothing for visitors when the episode isn’t published.
[benecaster_latest_episode] Renders a configurable display block for the latest published episode of a show.
[benecaster_platform_links] Renders “Listen on” platform badge links for a show — links to podcast platform listings (Apple Podcasts, Spotify, etc.).
[benecaster_player] Embeds an episode audio or video player.
[benecaster_related_episodes] Displays a list of related episodes based on the selected query strategy. Lists published episodes only, and renders nothing for visitors when its own episode isn’t published.
[benecaster_search] Full-text keyword search form for episodes.
[benecaster_show_description] Outputs the show’s short description or full description.
[benecaster_social_links] Renders the show’s social media profile links.
[benecaster_timestamp] Renders a clickable timecode link that moves its own episode’s player on the page to that point and plays it; with no player for that episode on the page, it stays a plain link.

Feeds

Help listeners subscribe in their podcast app: a subscriber’s own private feed address, a QR code for it or for your signup page, and a link to your public RSS feed.

Shortcode Description
[benecaster_feed_url] Displays the current subscriber’s personal RSS feed URL.
[benecaster_qr_code] Renders a QR code for a subscriber’s private feed URL (type="feed", needs a Benecaster account — Launch and above) or a show’s public signup page (type="signup", free on every plan including unlicensed WordPress.org installs).
[benecaster_rss_link] Renders a link to a show’s public RSS feed.

Listener Support

Ask listeners for donations, through Stripe or a link to your external donation page, and thank the ones who give.

Shortcode Description
[benecaster_donor_wall] Renders a paginated, public thank-you wall of Listener Support donations for a show.
[benecaster_listener_support] Renders a Listener Support prompt: a Stripe donation form or button, or a link to your external donation page.

Marketing

Site-wide text and links that do not belong to a show: your cookie notice and your own Benecaster referral link.

Shortcode Description
[benecaster_cookie_notice] Renders the GDPR cookie notice text set at Settings → GDPR / Privacy → Cookie Notice.
[benecaster_referral_link] Prints your own Benecaster referral link, for publishing anywhere on your site.

Subscribers

Sell your membership and show members what they have: subscribe and pricing displays, the subscriber account page, content gated by tier, follower signup, and recognition such as badges, tenure and supporter walls.

Shortcode Description
[benecaster_account] Renders the subscriber account dashboard.
[benecaster_current_tier] Outputs the name or slug of the highest tier the currently logged-in subscriber holds on a given show. Renders nothing, not even its fallback, for a show that isn’t connected to a Benecaster license.
[benecaster_erasure_request] Renders the form a subscriber, follower or donor uses to ask for their personal data to be erased.
[benecaster_follower_signup] Renders an email signup form that lets listeners follow your show for free. Shows a marketing-consent checkbox only when an add-on asks for one.
[benecaster_member_since] Outputs a subscriber’s membership tenure label or date for standalone placement in emails, page content, and theme templates.
[benecaster_member_thanks] Displays a list of members to thank on-air.
[benecaster_pricing_table] Renders a complete tier comparison table showing all tiers with their names and live prices, each price shown with its currency exactly as [benecaster_subscribe] shows it. On a membership-plugin show each membership level gets its own column, so a tier with a monthly and an annual level shows both, each named under the tier. Subscribe buttons link only when you set cta_url_base.
[benecaster_subscribe] Renders a subscription call-to-action with tier options, prices and a button to sign up — on built-in membership or a membership plugin. Its checkout shows a marketing-consent checkbox only when an add-on asks for one.
[benecaster_subscriber_count] Displays the current active subscriber count for a show.
[benecaster_supporter_wall] Renders a public wall of opted-in subscribers as an avatar / wall name / badge-chips card grid. order="tier" puts the highest tier first, ranked by the tier’s position in the show’s tier list, with the longest-standing supporters first within each tier.
[benecaster_tier_gate] Shows its content to subscribers holding a tier at or above the one you name, and the content after [benecaster_else] to everyone else.
[benecaster_tier_name] Outputs the display name of a tier, pulled live from the active subscription bridge.
[benecaster_tier_price] Outputs the current price for a membership tier, read live from your built-in membership or membership plugin.
[benecaster_user_badge] Renders a user’s badge chips (tier-auto grants + manual grants) inline.

Add-on Shortcodes

These work once the add-on is installed and switched on for the show. Without it, the shortcode shows nothing.

Shortcode Add-on Description
[benecaster_ai_search] AI Search Semantic natural-language search across episode titles, descriptions, show notes, and — when the Transcription add-on is installed — transcripts.
[benecaster_guest_section] Guest Manager An episode’s guests anywhere on the site: in its own show notes, on a landing page, or beside an embedded player.
[benecaster_guests] Guest Manager The guest list: every published guest on a published episode, A–Z, each linking to their guest page.
[benecaster_guest] Guest Manager One guest’s card: photo, name linking to their guest page, title and organization, bio, and their website and social links.
[benecaster_transcript] Transcription Service An episode’s interactive transcript anywhere on the site.

Blocks and Elementor Widgets

With the free Blocks & Widgets Library, these shortcodes are also blocks in the block editor and widgets in Elementor, with point-and-click settings. A block saves the shortcode it stands for, so the shortcode keeps working if the add-on is removed. The shortcodes themselves accept every attribute below — the right-hand column is only what the block leaves out.

Shortcode Block The block leaves out
[benecaster_player] Episode Player —
[benecaster_latest_episode] Episode Card Sections are fixed: artwork, title and description
[benecaster_subscribe] Subscribe CTA —
[benecaster_feed_url] RSS Feed URL Display —
[benecaster_episodes] Latest Episodes —
[benecaster_subscriber_count] Subscriber Count —
[benecaster_subscriber_count] + [benecaster_episode_count] Show Stats tier on either count
[benecaster_pricing_table] Pricing Table —
[benecaster_listener_support] Listener Support The link-mode styles as explicit choices (the default follows your settings)
[benecaster_donor_wall] Donor Wall —
[benecaster_qr_code] QR Code —
[benecaster_episode_nav] Episode Navigation —
[benecaster_related_episodes] Related Episodes —
[benecaster_episode_share] Episode Share —
[benecaster_social_links] Social Links —
[benecaster_platform_links] Platform Links —
[benecaster_rss_link] RSS Link —
[benecaster_transcript] Transcription (needs the Transcription Service add-on) —
[benecaster_ai_search] AI Search (needs the AI Search add-on) —
[benecaster_guest_section] Episode Guests (needs the Guest Manager add-on) —
[benecaster_guests] Guest List (needs the Guest Manager add-on) —
[benecaster_guest] Guest Card (needs the Guest Manager add-on) publications, the guest’s publication links

See Available Blocks for every block’s settings.

See Also

Need this built rather than just documented? See our services →

Last updated