Public Attendee List

The Public Attendee List powers the Who’s Attending feature on your event page while using Event Tickets Plus, but it can do much more. It is a list of all of the attendees for an event, allowing you and others to see who is attending the event. This is powered by the API, which is public. You can learn more about APIs in our REST API article.

We have combined the end-user permissions for the full Public Attendee List and the Who’s Attending block. At this time, we do provide a way for users to opt-out from these.

Viewing attendees

In Classic Editor mode, select Settings from the Tickets meta box then chose the option to Show attendees list on event page.

Tickets back end editor in Classic mode
Ticket meta box in the WordPress Classic editor
Enable “Who’s Attending” to display on the front end of your site

If you have enabled the WordPress Block editor (a.k.a Gutenberg), you will add the Attendee List to your event, page or post using the Ticket block.

The Attendee List block in the WordPress Block editor
The Attendee List block added to the post

👋 If the published tickets do not display the Who’s Attending/Attendee List, it will be assumed in Event Tickets 4.12 and forward that users will also not be included on the Public Attendees list.

Displaying attendees

Once the attendee list has been enabled, visitors are able to opt into being displayed on the list during registration. You are able to display the attendees who have opted in in a variety of ways.

Some WordPress themes and plugins provide custom solutions to display attendees within widgets and sidebars. You could also integrate this with your own mobile app, other content management systems, and more.

To access all attendee registrations that are publicly available for all events on your site, go to this link on your own website:

[yoursite.com]/wp-json/tribe/tickets/v1/attendees/

To access all attendee registrations that are publicly available for just a single ticket within an event, this is the link you can use:

[yoursite.com]/wp-json/tribe/tickets/v1/attendees/260

That number at the end of the URL coordinates with the Ticket ID. To find that, go to Events from the WordPress dashboard. Mouse over the attendees list (or get there while editing the single event).

Ticket ID is visible in the Status column

The Public Attendee API can be used in a variety of ways. Developers may use it to make their own widgets or other ways of displaying publicly available attendees.

One of the things to remember is that the Public Attendee API, like all WordPress APIs, is public. So all user data is publicly accessible.

The Public Attendee API will display like this.

👋 For users to appear within the Public Attendees API, the Who’s Attending/Attendee List must be enabled on published tickets AND the end purchaser must uncheck the opt-out prompt within Event Tickets 4.12+.

Opting out of the attendee list

To be shown in the public attendee results, users will need to uncheck the box, allowing themselves to be publicly visible as attending the event. We have made the default option to be opt-out to comply more closely with GDPR, California Customer Privacy Act, and similar best practices.

Hiding the attendee list option

👋 If you use the Who’s Attending feature on your site, but hide the opt-out question, users will be hidden from the Public Attendee List.

Since Event Tickets Plus 4.11.2, both Classic and Block users will see an opt-out form below tickets on the front end of their website. Previously, this feature was only displayed within the RSVP Block (not Classic mode).

By default, users will be opted-out of the Public Attendee API.

👋 You can hide the opt-out form so users do not need to opt-in or opt-out of being displayed in the list. However, this makes complying with GDPR and other policies more complex. Proceed with caution.

Add this CSS snippet to your theme’s styles (or using a style override) to hide the option:

.tribe-tickets-attendees-list-optout--wrapper {
    display: none !important;
}

It’s also possible to hide the option using the tribe_tickets_plus_hide_attendees_list_optout filter in your functions.php file or as a separate plugin.

add_filter( 'tribe_tickets_plus_hide_attendees_list_optout', '__return_true' );

You can find the functions for Tickets and RSVPs in their respective repositories.

User permissions

It’s possible to set permissions that restrict which user accounts are able to view and manage attendee lists in WordPress. For example, you can use the tribe_manage_attendees capability to grant access to, say, the Editor, Administrator, and Super Administrator roles. The WordPress developer guide has more information on setting up user roles and permissions. You can find the full list of tickets capabilities see our guide: Editing User Roles and Permissions.

Bear in mind, if you are creating accounts for staff to check attendees in, we recommend that they have Contributor level permissions. This means that if they need to switch to manually checking guests in, they may not have access to see all attendees.

Table of Contents

Details

Report an issue