Locked Episodes in AI Search Results
An AI Search box can treat episodes a visitor can’t open in one of two ways: leave them out, or show them locked with a link to subscribe. Each [benecaster_ai_search] box chooses with its result_visibility attribute.
The Two Modes
result_visibility |
Episodes the visitor can’t open |
|---|---|
hidden (the default) |
Left out of the results |
locked |
Kept in their ranked place, as a locked card |
The ranking is the same in both modes. A member who holds the tier an episode needs sees it as a normal result in either mode.
[benecaster_ai_search result_visibility="locked"]
What a Locked Card Shows
A locked card has a padlock, the episode’s title as a link to its page, a line saying who can listen, and a Subscribe to access link to the show’s sign-up page.
The line reads Available to {tier} subscribers when exactly one paid tier opens the episode, and Available to subscribers otherwise.
A locked card never shows anything else about the episode: no date, no description or excerpt, and nothing from its transcript, whatever the search matched.
Why Show Locked Episodes
A locked result tells a visitor you have an episode about exactly what they searched for, and puts the subscribe link right there. On a public search bar that turns a search into a reason to subscribe. Inside a members’ area, where everyone is already subscribed to something, hidden results usually read better.
Because each box has its own mode, one site can use both: a public bar set to locked and a members’ area set to hidden, even on the same page.
Changing the Link
Two attributes change the subscribe link:
locked_cta_url— where the link goes, instead of the show’s sign-up page.locked_cta_label— the link’s words, instead of Subscribe to access.
[benecaster_ai_search result_visibility="locked" locked_cta_url="/join/" locked_cta_label="Join to listen"]
Pinned Results
A pinned result follows the same rule. In a hidden box, a pinned episode the visitor can’t open is left out. In a locked box it shows first, locked.
Transcripts
With Transcription Service, a search matches what was said in an episode only for a visitor allowed to see that episode’s transcript. For anyone else, an episode is placed by its title, description and show notes, whichever mode the box uses. See AI Search Overview.
A guest’s passages under In their own words follow the same rule, more strictly: a passage is shown only to a visitor who may open its episode and see its transcript (the transcript’s visibility on Show Settings → Transcription, or the episode’s own). Anything else is left out entirely, in locked mode as in hidden: a members’ episode can still appear in the list as a locked card, but none of what was said in it is shown or sent. See What a Guest Said.
When you test this on your own site, sign out or use a member’s account. Signed in as yourself, you can open every episode and see every transcript.
For Developers
benecaster_ai_search_locked_result replaces the locked card’s markup. See Show locked search results, or replace their card.
See Also
Need this built rather than just documented? See our services →
Last updated