Guest Manager Overview
The Guest Manager add-on gives every guest on your podcast a profile of their own: name, title, organization, bio, photo, website and social links, kept in one roster on the Guests screen. You link guests to episodes from the episode editor, and each guest gets a public page listing their episodes.
Your guests belong to your site, not to one show. If you run several shows, they all share the same roster, so a guest who appears on two of your shows has one profile.
Guest Manager works on every Benecaster plan, Launch included, and needs Benecaster 0.0.22 or higher. Buy it from its shop page, install it like any other add-on (see Installing Add-ons), and switch it on for the shows you want under Benecaster → Settings → Add-ons → the Guest Manager card → Active on.
On an older Benecaster, Guest Manager does not start, and administrators see Guest Manager requires Benecaster 0.0.22 or higher. This site is running …, so Guest Manager has not been activated. Update Benecaster, and Guest Manager starts.
Finding the Guests Screen
While Guest Manager is switched on for at least one of your shows, Guests (with a people icon) appears in the Benecaster admin’s left-hand menu. Only administrators can open it.
The screen follows the show selected at the top of the Benecaster admin. If Guest Manager is off for that show, the screen reads:
Guest Manager is off for this show. Guest profiles aren’t shown here. Episode guest credits still work without it. Switch Guest Manager on for this show under Settings → Add-ons.
with a Go to Add-ons → link that takes you there. You can also pick a show it is switched on for. The roster is the same whichever of those shows you pick.
If you switch Guest Manager off for every show, the Guests item leaves the menu. Your guests are kept, and come back when you switch it on again.
Your Guest Roster
Benecaster → Guests lists every guest on your site, A to Z, 20 to a page. Use ← Previous and Next → below the list to move between pages.
| Column | Shows |
|---|---|
| Guest | The guest’s photo, name, and their title and organization (Title, Organization, or whichever is set). Click the name, or anywhere on the row, to open their profile. |
| Episodes | How many published episodes the guest appears in, such as 3 episodes. |
| Latest appearance | The title and date of the newest of those episodes, or None yet. |
The episode counts cover every show on your site, including shows where Guest Manager is switched off, as the line under the list says: Episode counts include published episodes on every show. Drafts and scheduled episodes are not counted.
To find someone, type in Search guests by name, organization or email. The list updates as you type and matches a guest’s name or organization. A whole email address finds the one guest with that email; part of an address is searched as a name.
Below the list are the Public guest directory box (see The Public Guest Directory) and, when there are typed guest names waiting, the Import Existing Guests box.
Adding or Editing a Guest
Click Add Guest at the top of the roster to create a guest, or click a guest’s name to edit them. The profile has these fields:
| Field | What it holds |
|---|---|
| Name | Required, up to 200 characters. |
| Title | Their job, or what they are known for. |
| Organization | Optional. The company, school or group they are with. Shown after their title, and found by the guest search. |
| Bio | A few paragraphs about the guest. |
| Photo | Click Choose Photo to pick an image from your WordPress media library. Once a photo is set, Change Photo swaps it and Remove Photo takes it off the profile. |
| Website | The guest’s own site. It must start with http:// or https://. |
| Optional and private: never shown on your site, in your feed or in an export. No two guests can have the same email. | |
| Social Links | Click Add Link for each profile you want to list. Type the platform (for example LinkedIn) and the address, which must start with http:// or https://. Remove takes a link off. |
Click Save Guest. On a new guest, the screen moves to their saved profile. On a guest you are editing, Saved. appears beside the button. A saved guest’s profile has a View Guest Page link beside ← All guests, which opens their public page.
If something cannot be saved, the reason appears under the field concerned. For example, a website address that does not start with http:// or https:// shows Enter a website address starting with http:// or https://. Fix it and click Save Guest again. A social link row you added and left completely empty is simply dropped when you save.
If you try to leave a profile with unsaved changes, Benecaster asks you first. ← All guests takes you back to the roster.
Publications
The Publications section, after Social Links, lists the guest’s own work: books, articles, papers. Click Add Publication for each one:
| Field | What it holds |
|---|---|
| Title | Required. |
| Link | Optional. Must start with http:// or https://. |
| Year | Optional, four digits, such as 2024. |
| Type | Book (the default for a new row), Article, Paper or Other. |
| Affiliate link | Tick it when the link earns you a commission. It is kept only on a row with a link. |
Move Up and Move Down set the order, which is the order they are shown in; Remove takes a row off. A row left completely empty is dropped when you save. If a row can’t be saved, the reason appears under it: Give the publication a title, or remove it., Enter a link starting with http:// or https://, or leave the link empty. or Enter the year as four digits, such as 2024, or leave it empty.
Tracking clicks with Outlinks. While the Outlinks add-on is on for at least one show, a row with a link has Track with Outlinks. It makes the link a site-wide tracked link, and the row then reads Tracked with Outlinks as {/go/ address} with Stop Tracking. Change a tracked row’s link and the new address is tracked when you save; the old /go/ link keeps redirecting. Publication links you don’t track are still checked by Link Health.
A Guest’s Email
An email is saved in lower case, without spaces at either end. Guest Manager uses it to keep each guest to one profile:
- An address that isn’t a whole email address is refused with Enter a whole email address, such as name@example.com.
- An address another guest already has, in any letter case, is refused with “{Name} already has this email.” and an Open that guest button that takes you to their profile.
The email is covered by WordPress’s personal-data tools: see Guests and Privacy Requests.
Custom Fields
If you have field groups attached to Guest on Benecaster → Fields (see Custom Fields), the profile has a Custom Fields section below Social Links: one block per group, headed with the group’s name, each field drawn by type as on episodes. A required field shows a red *, but saving without it is allowed. With no group attached to Guest, the section doesn’t appear.
Save Guest saves the custom fields after the rest of the profile. If they cannot be saved, the screen says The guest was saved, but their custom fields were not: {reason} Press Save Guest to try again. On a new guest, the message appears on their saved profile and ends Enter them again and press Save Guest.
Appearances
A saved guest’s profile ends with Appearances, every episode the guest is linked to, on every show: Linked to 3 episodes, on every show. and a table of Episode, Show and Date, newest first. Date is the publish date, or Draft, Scheduled, Pending review or Private, with drafts last. Click an episode’s title to open it in the episode editor.
An episode on a show where Guest Manager is off is still listed, marked Guest Manager is off for this show, so this episode shows no guests. A guest with no episodes reads Not linked to any episode yet.
Deleting a Guest
Open the guest’s profile and click Delete Guest at the bottom. Benecaster asks you to confirm: Delete {name}? Their profile is removed for good and they are unlinked from every episode. This cannot be undone.
Deleting a guest:
- removes their profile permanently. There is no trash to restore it from.
- unlinks them from every episode they were linked to. The episodes themselves are not changed otherwise.
- leaves their photo in your media library, in case you use it elsewhere.
- removes any Guest portal changes waiting for approval, their waiting photo and their link.
Linking Guests to an Episode
On a show where Guest Manager is on, the episode editor’s Guests tab holds Guest Manager’s guest selector in place of the plain list of typed names. It shows the guests linked to the episode in order, each with their Title, Organization, ↑ and ↓ to move them, and Remove.
To link a guest, type in Add a guest (Search guests by name, organization or email). Each result has Link, or a greyed Linked if the guest is already on the episode. When no result has exactly the name you typed, Create guest “…” creates a guest with just that name and links them; fill in the rest of their profile later on the Guests screen.
Create guest “…” also has an optional Email for the new guest (optional) box. If a guest already has that email, they are linked instead of a new guest being made: “Linked to existing guest: [Name].”, or This email belongs to [Name], who is already linked to this episode. Typing a whole email address into the search finds that guest; an address nobody has shows No guest has this email. To add them, search by their name and give the email when creating them.
On a saved episode, each link, removal and move is saved at once, without Save Draft or Publish, and your feed updates. Linking adds the episode note Guest linked: {name} added to this episode., and removing one adds Guest removed: {name} unlinked from this episode. Moving a guest adds no note.
On a new episode, the guests you choose are held until you first save it: These guests are linked to the episode when you first save it. They count as unsaved changes until then: leaving the episode (the ← Episodes link, another screen, Back, switching show or reloading) asks You have unsaved changes. Leave without saving them?, and leaving anyway loses them. Switching the editor’s tabs does not ask, and removing every held guest clears the warning. If you save the episode to a show where Guest Manager is off, nothing is linked.
If the episode has guest names typed before Guest Manager that no linked guest matches, they are named under the search: Typed on this episode before Guest Manager: {names}. The episode page shows these names until a guest is linked here. To turn them into guest profiles, use Import Existing Guests on the Guests screen.
Feed Credits, below the selector, works as before. See Creating Episodes for the rest of the episode editor.
Guests on Your Episodes
On a show where Guest Manager is on, the guests linked to an episode appear in three places:
- The episode page. Its Guests section lists them in the episode’s order: each guest’s name, linked to their Website in a new tab when they have one (a plain name otherwise), then Title, Organization and their Bio.
- Your feed. Each episode carries one
<podcast:person role="guest">per linked guest, with their Website and Photo, for podcast apps that show guests. Organization and email are not in the feed. See Podcasting 2.0 Support. - The episode editor. On the episode’s Guests tab, under Feed Credits, as locked rows marked via Guest Manager, with a view source link to the guest’s profile.
Your feed updates by itself when you save or delete a guest, and when you switch Guest Manager on or off for a show.
Names typed into the Guests tab. An episode can also have guest names typed into its Guests tab, the list that comes with Benecaster. Until a guest is linked to the episode, its page shows those typed names. Once one guest is linked, only linked guests are shown, never both. The typed names stay saved in the episode, and come back if every guest is unlinked. On a show where Guest Manager is off, the page shows the typed names and the feed carries no guests from Guest Manager.
The Guests in This Episode Block
For a richer guest section, switch on Show Settings → Templates → Episode Page Blocks → After Content → Guests in this episode and save. It is off by default, and greyed with (requires Guest Manager) on a show where Guest Manager is off.
On, each episode the visitor can open shows a section headed Guests after the show notes: each linked guest in the episode’s order, with their photo (96 × 96), their name linked to their Website in a new tab, Title, Organization, and the first 30 words of their Bio, ending ….
Guests show once. When the block draws on an episode, the page’s usual Guests section is left out. An episode with only typed guest names shows no block and keeps the usual section. A locked episode shows no Episode Page blocks, so its visitors see the usual section.
Same Guest Related Episodes
Wherever a related-episodes list can be set to Same guest (the Related Episodes Episode Page block’s Which episodes to list, or [benecaster_related_episodes query="by_guest"]), a show with Guest Manager on lists that show’s published episodes sharing at least one linked guest with the episode, newest first, up to the list’s count. An episode with no shared guest lists episodes on the same topic (tag), then the latest episodes. Other shows’ episodes and drafts never appear. On a show with Guest Manager off, Same guest lists by topic.
Each Guest’s Public Page
Every guest has a public page at /guests/{name}/ (/?benecaster_guest_page={name} if your site uses plain permalinks). It shows your theme’s header, then the guest’s photo, name (also the browser tab’s title), title, organization on a line of its own, and bio, a Website link and one link per social link, each opening in a new tab.
Publications follow, under that heading, in the order you set: each title (linked when it has a link, through its /go/ address while it is tracked and Outlinks is running), then its type and year, such as Book, 1962. Every link opens in a new tab. When at least one is an affiliate link, Some of these links are affiliate links. appears under the list, and affiliate links carry rel="sponsored nofollow" so search engines know.
Below, Episodes lists the guest’s published episodes on shows where Guest Manager is on, as Benecaster’s episode cards, newest first. A guest who has been on more than one show gets a heading per show (the show’s name), the show with their latest appearance first and each show’s episodes newest first; a guest from one show gets a single list with no heading. An episode the visitor can’t open shows locked, under its show. A guest with none reads No episodes with this guest yet.
An address that matches no guest is your site’s usual “not found” page. If you switch Guest Manager off for every show, the guest pages go too. Open a guest’s page from their profile with View Guest Page.
The Public Guest Directory
The Public guest directory box under the roster offers three choices, and a choice saves as soon as you pick it:
- Off (the default): No public guest directory. Each guest’s own page still works.
- One combined directory: Lists your guests A–Z on a public page at /guests/, with a search by name or organization. Only guests in a published episode on a show with Guest Manager on are listed. While on, it takes the /guests/ address, even from a page of your own there.
- Combined, plus one for each show: Keeps /guests/, and gives each show with Guest Manager on a directory of its own at its show address followed by /guests/, listing and searching only the guests in that show’s published episodes.
With a directory on, View Guest Directory opens /guests/ in a new tab. With per-show directories on, View the directory for {show name} does the same for each show.
On, /guests/ (/?benecaster_guest_directory=1 under plain permalinks) shows the heading Guests, a Search guests by name or organization box with Search, then the guests A–Z, 30 to a page, with ← Previous, Page N of M and Next →. Each guest shows their photo, their name linking to their own page, and Title, Organization.
A search shows N guests match “…”. with Show all guests, or No guests match “…”. The public search never matches an email.
The Show filter. While Guest Manager is on for more than one show, /guests/ has a Show select beside the search: All shows by default, then each of those shows A–Z. Choose one and press Search to list only that show’s guests, combined with any name or organization search. The address keeps both (/guests/?guest_show={show}&guest_search=…), and so do the page links and Show all guests. An address naming a show that doesn’t exist or has Guest Manager off is ignored, and every show’s guests are listed.
Each show’s own directory. With Combined, plus one for each show, each show with Guest Manager on also has a directory at its show address followed by /guests/ (for example /show/haunted-houses/guests/). It is headed Guests on {show name} and lists and searches only the guests in that show’s published episodes, A–Z, the same way /guests/ does. A show with Guest Manager off has none: its address is your site’s “not found” page.
Off, /guests/ is your site’s “not found” page, or your own page if you have one there, and no show has a directory of its own. Guest pages work either way.
The Guest Portal
The Guest portal lets a guest update their own profile through a private link you email them. They need no account or password, and nothing they send appears on your site until you approve it.
Switching It On
The Guest portal box sits at the bottom of the Guests list, under Public guest directory. It is off by default and covers the whole site. Switching it off stops every link at once; a link that has not expired works again when you switch it back on.
Inviting a Guest
While the portal is on, a saved guest’s Edit Guest screen has a Guest Portal section. Click Invite to Edit Profile to email the guest a private link that works for 14 days. The email’s subject is Update your guest profile on {site title}, sent with your site’s title as the sender’s name. The button is greyed out, with Add an email for this guest and save to invite them., until the guest has a saved email.
Once a link is sent, the section reads The guest has a link to edit their profile. It works until {date}., with:
- Send a New Link, which emails a fresh link. The old one stops working.
- Stop Access, which ends the link straight away.
What the Guest Sees
The link opens Edit Your Guest Profile, in your theme’s look, at /guests/{name}/edit/. The guest can change their Title, Organization, Bio, Photo (a new JPEG, PNG or WebP under 2 MB, or Remove my photo), Website and Social links. They can never change their name or email. They press Submit for approval and see Thanks — your changes will appear once they are approved.
- The bio can be up to 5,000 characters, the title and organization 200 each, and there can be up to 10 social links.
- Sending again replaces what they sent before. Coming back to the link shows You sent changes on {date}, and they are waiting for approval. Submitting again replaces them.
- A link can be used for 10 submissions an hour.
- A wrong, expired, replaced or stopped link, or the portal switched off, shows only This link does not work. It may have expired, been replaced by a newer one, or been switched off. Please ask whoever invited you for a new link.
- Search engines don’t index the page, and it is never cached.
Approving Changes
When a guest sends changes, your site’s admin address (Settings → General → Administration Email Address) is emailed {Name} sent guest profile changes for approval. The email names the fields changed, never what was sent, and links to the list.
The Guests list shows N waiting for approval with Review, which opens Waiting for Approval. Each guest shows Sent {date} and a table of Field, Now and Sent by the guest, with the current and new photo side by side.
- Approve applies only what the guest changed, just as if you had made the edit yourself, so your feed updates too. A field you have edited since keeps your value. A new photo joins your media library as Photo of {Name}. The guest is emailed Your guest profile changes on {site} are live, with a link to their page.
- Decline asks you to confirm, then throws the changes and any new photo away. The guest is emailed that their changes were not approved.
A guest you delete while their changes are waiting drops off the list.
Clean-up
Deleting a guest, on the Guests screen or with WP-CLI, also removes their waiting changes, photo and link, even with Guest Manager off on every show. Benecaster’s uninstall (with data deletion on) and Reset Plugin Data remove the Guest portal setting, every link, every waiting change and every waiting photo. For privacy requests, see Guests and Privacy Requests.
Guest Shortcodes
Three shortcodes place guests anywhere on your site. Each draws nothing where Guest Manager is off, and never shows the tag as text.
[benecaster_guest_section]lists an episode’s guests the way the Guests in this episode block does: the episode being shown, or the one named withepisode_id. Options:title,bio(excerpt,fullornone) andphotos. Placed in an episode’s own show notes, it takes the place of the page’s usual Guests section, so guests show once.[benecaster_guests]puts the guest list, A–Z with a search by name or organization, on any page, whether or not the/guests/directory is switched on. Options:title,search,per_pageandshow: empty for every show (the default), a show’s ID or slug for that show’s guests, orcurrentfor the show of the page being viewed (a show’s page, or an episode’s show; every show on any other page). A show that doesn’t exist or has Guest Manager off lists nobody (No guests yet.).[benecaster_guest guest="…"]draws one guest’s card: photo, name linking to their page, Title, Organization, bio, website and social links. Options:bio,photo,linksandpublications(publications="true"adds the guest’s publications after the links; off by default).
Every option and value is in Place guests anywhere with Guest Manager’s shortcodes. With the free Blocks & Widgets Library, all three are also blocks and Elementor widgets: Episode Guests, Guest List and Guest Card.
Importing Guests You Already Typed
If your episodes have guest names typed into their Guests tab, Guest Manager can turn them into guest profiles linked to those episodes. While any are waiting, on a show where Guest Manager is on, the roster shows an Import Existing Guests box, for example 4 guest names typed into your episodes before Guest Manager can become guest profiles, linked to their episodes., with Review and Import and Not Now.
Review and Import lists one group per name, A to Z. Names that differ only in capitals, accents or full stops are one group. Each group lists its episodes with their show, date (or Draft or Scheduled) and how the name was typed. For each group:
- If the name matches a guest already on your roster, the group links to them: Link to {name}, already on your roster. Otherwise it creates a guest: Create a new guest, with Name and Website you can change first, and an optional Email (optional) box: Private. If a guest already has this email, these episodes are linked to them instead of a new guest being created.
- Untick an episode to leave it out. It stays waiting for a later import.
- Untick Import this guest now to leave the whole group for later.
Click Import Guests. The screen reports what it did, for example Imported. Guests created: 3. Existing guests linked: 1. Episode links added: 7., and lists anything still waiting. Each guest is added after any guests the episode already has, in the order the names were typed, and each link adds the episode note Guest linked: {name} added to this episode. Your feeds update.
If an email isn’t a whole address, or the same email is given to two groups, nothing is imported: Nothing was imported. Fix the emails below, then import again., with a line for each group concerned. What you typed is kept, so you can fix it and click Import Guests again.
The names typed into the episodes are kept. Not Now hides the box until something new is waiting. Shows where Guest Manager is off are never included.
The Guest Manager Tour
The Tours panel (the Tours link at the bottom right of every Benecaster admin screen) has a Guest Manager Tour wherever Guest Manager is on for at least one show. It points out the Guests menu item, a guest’s profile fields, a new episode’s Guests tab and View Guest Page. With the selected show’s Guest Manager off, the tour is its first step alone.
Your Guests in Your Data Export
Guest Manager adds two sheets to Benecaster → Settings → Your Data: Guests and Guest Appearances. See Exporting Your Data for what each holds. A guest’s email is never in either sheet.
Guests and Privacy Requests
A guest’s email is covered by WordPress’s own privacy tools, even with Guest Manager off on every show:
- Tools → Export Personal Data for a guest’s email includes their guest profile, with their publications, plus any Guest portal changes waiting for approval and whether they have a working Guest portal link (never the link itself).
- Tools → Erase Personal Data removes the email from the profile, throws away any waiting Guest portal changes and photo, and stops their link. It keeps the rest of the profile, reporting Guest profile kept: {Name}. Delete it on the Guests screen if the request covers it.
See Privacy and Data Handling for the rest of what Benecaster does with these requests.
With Podcast Workflow
On a show that also has Podcast Workflow, the Workbench’s Guest preparation tile (off until you turn it on in the show’s Workflow settings) lists each episode’s guests, each linked to their record on the Guests screen. Edit guests opens the episode editor’s Guests tab, which is where guests are chosen, and Guest preparation complete marks the tile done once they’re ready.
For Developers
The roster, the editor, the episode editor’s selector, the directory switch and the import all run on Guest Manager’s own REST routes, and other plugins read guests through public functions. Each is documented with examples:
- Read, create, change or delete guests from code
- Read an episode’s guests from another add-on
- Read one guest by id from another add-on
- Run or watch the guest import from code
- Link, unlink or reorder an episode’s guests from code
- Style, replace or hide the Guests in this episode block
- Same guest related episodes, and adjusting them
- Restyle, extend or override a guest’s public page
- Switch on, restyle or extend the public guest directory
- Place guests anywhere with Guest Manager’s shortcodes
- Map transcript speakers to guests
- Invite a guest to the Guest portal, or stop their link, from code
- Restyle the guest’s own Guest portal form, or act when a guest sends changes
- Approve or decline guests’ Guest portal changes from code
See Also
Need this built rather than just documented? See our services →
Last updated