[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.
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"]