Skip to content
Tickets Please

Venues

Venues represent the physical locations where your events take place. Each venue is its own post type (tribe_venue) with address fields, geographic coordinates, and a dedicated page on your site. Attach a venue to an event and its address, map, and contact details display automatically on the event page.

Creating a Venue

You can create venues in two ways:

From the Venues Admin

  1. Go to Events > Venues in your WordPress admin.
  2. Click Add New.
  3. Enter the venue name (required) and fill in the fields below.
  4. Click Publish.

Inline from the Event Editor

While editing an event, open the Venue dropdown and select Create New. A set of inline fields appears where you can enter the venue name and address without leaving the event editor. The venue is saved as a draft when you save the event, and published when you publish the event.

The venue dropdown supports type-ahead search. Start typing a venue name and matching results appear immediately.

Venue Fields

FieldRequiredDescription
NameYesThe venue name, used as the post title
DescriptionNoRich text description shown on the venue page
AddressNoStreet address line
CityNoCity name
State/ProvinceNoState or province name
Postal CodeNoZIP or postal code
CountryNoSelected from a dropdown of 50+ countries
PhoneNoContact phone number for the venue
WebsiteNoExternal URL for the venue (validated with esc_url_raw)
LatitudeNoDecimal degrees from -90 to 90
LongitudeNoDecimal degrees from -180 to 180
Video URLNoA URL to a video tour or livestream of the venue
Show MapNoToggle to display an embedded map on event pages

Address Formatting

Tickets Please includes a format_address( $post_id ) helper that builds a formatted multi-line address from the venue’s individual fields. This helper is used internally by templates and is available for use in your own code:

$formatted = Tickets_Please_Venue::format_address( $venue_id );

The output combines the address, city, state, postal code, and country into a standard mailing address format, skipping any fields that are empty.

Coordinates and Maps

Enter latitude and longitude manually, or let them be populated through geocoding if you have a Google Maps API key configured in Events > Settings. The sanitize_coordinate() method validates that latitude stays within -90 to 90 and longitude within -180 to 180.

When Show Map is enabled and valid coordinates exist, the venue displays an embedded map on any event page that uses it. The map also appears on the venue’s own page.

Venue Pages

Each venue gets its own page at /venue/{slug}/. This page displays the venue description, formatted address, map (if enabled), and a list of upcoming events at that venue.

Venue pages use the standard WordPress template hierarchy. You can override the template in your theme by creating a single-tribe_venue.php file.

Linking a Venue to an Event

On the event editor, the Venue meta box (or block) shows a dropdown of all published venues. Select one, and the event stores the venue’s post ID in its meta. Each event links to exactly one venue. If you need to change it later, open the dropdown and pick a different venue.

Removing a venue from an event does not delete the venue. Deleting a venue does not delete any events — the events simply no longer have a linked venue.

Custom Capabilities

Venue management uses its own set of capabilities, separate from events:

  • edit_tribe_venues — create and edit own venues
  • edit_others_tribe_venues — edit venues created by other users
  • publish_tribe_venues — publish venues
  • delete_tribe_venues — delete own venues
  • read_private_tribe_venues — view private venues

By default, these capabilities map to the Administrator and Editor roles. You can use a role management plugin to grant venue editing to other roles.

Common Questions

Can I assign multiple venues to one event? No. Each event links to a single venue. If your event spans multiple locations, create a venue that represents the overall area and note the specific locations in the event description.

Do I need coordinates for the map to work? Yes. The embedded map requires valid latitude and longitude values. Without them, the Show Map toggle has no effect.

Can I reuse a venue across many events? Yes. That is the primary purpose of the venue post type. Create it once, and select it from the dropdown on any number of events.

How do I update a venue’s address for all linked events? Edit the venue directly at Events > Venues. Since events store only the venue ID (not a copy of the address), all events linking to that venue will automatically display the updated address.

Can visitors see a list of all venues? Venue archive pages are available if your theme supports them. The default URL pattern is /venue/. Each individual venue page lists upcoming events at that location.

What happens if I delete a venue? Events that linked to the deleted venue will no longer display venue information. The events themselves are not affected — they continue to exist without a venue reference.

Next Steps