Skip to main content

Locked Episodes in AI Search Results

Required add-on: Ai Search

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.

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