[benecaster_episode_link]
Renders a styled inline link to another episode. Designed for use in show notes and episode content written in the TipTap editor — type @ in the episode content field to open the episode picker, search by title or episode number, and select an episode to insert this shortcode as an inline node.
In the editor the node displays the episode title as styled text. On the front end it renders as an a tag pointing to the episode page. The label attribute overrides the display text and supports the {{episode_number}} merge tag.
The linked episode must be published. For a draft, scheduled, private, pending or trashed episode the shortcode renders nothing for visitors, so show notes never link to an episode that isn’t out yet; anyone who can edit that episode still sees the link, as with [benecaster_player].
Output filterable via benecaster_episode_link_output.
Parameters
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
episode_id |
int |
— | Yes | ID of the episode to link to. Required. |
show_id |
int |
(current show)
|
No | ID of the show. Used to resolve the episode title when label is not set. |
label |
string |
(episode title)
|
No | Display text for the link. Defaults to the episode title. Supports {{episode_number}} merge tag. |
Example
<!-- Standard episode link — renders the episode title as a link -->
[benecaster_episode_link episode_id="42"]
<!-- Custom prose label -->
[benecaster_episode_link episode_id="42" label="our deep dive on monetization"]
<!-- Episode number label using merge tag -->
[benecaster_episode_link episode_id="42" label="Episode {{episode_number}}"]
<!-- Specific show context -->
[benecaster_episode_link episode_id="42" show_id="3" label="that episode"]