GigRoute Events
GigRoute Events is a WordPress event management plugin built for bands, musicians, artists, stand-up performers, show business teams, venues, and entertainment websites that need a clean way to publish upcoming shows and guide visitors toward tickets.
The plugin adds a dedicated Event post type, event details, ticket URLs, location taxonomies, event statuses, posters, frontend filters, and a dynamic Gutenberg block for displaying tour dates and live events anywhere on your site.
Whether you manage a band website, a comedy tour page, an artist profile, a festival landing page, or a promotional website for live shows, GigRoute Events helps you keep event information structured, searchable, and easy to promote.
Built for ticket promotion
GigRoute Events helps visitors move from event discovery to ticket action. Each event can include a Ticket URL, venue information, date and time, city, state, country, event type, status, and an optional poster image.
This makes it easier to build pages such as:
- Upcoming tour dates
- Concert schedules
- Stand-up show calendars
- Festival appearances
- Artist event listings
- Venue and city-based event pages
- Ticket-focused landing pages
The frontend block can show a clear “Buy tickets” link for each event and automatically switch to a sold-out label when an event is marked as sold out.
Key features
- Custom Event post type with title, editor, excerpt, and featured image support.
- Event date and time fields with local timezone handling and stored UTC values.
- Ticket URL and external event source URL fields.
- Venue name, latitude, longitude, and related post ID fields.
- Event Type, Event Status, City, State, Country, and Tour Series taxonomies.
- Default Event Type and Event Status management.
- ISO 3166-1 alpha-2 country code support for event countries.
- Gutenberg block for displaying event lists on pages and posts.
- Upcoming, past, and all-events display modes.
- Optional frontend filters by event type, country, city, status, and series.
- Optional pagination for event lists.
- Configurable event date output formats with localized editor previews.
- Optional ticket links in frontend event lists.
- Sold-out and free-event metadata.
- Event poster image support.
- Optional global poster for all events.
- Optional poster link wrapping for ticket or promotional links.
- Parent recurring events with one-time manual generation of occurrence posts.
- Recurring event controls for active, paused, and ended series states.
- Admin recurrence filters for single events, parent recurring events, generated occurrences, and modified generated occurrences, shown only when matching posts exist.
- Occurrence-level overrides for ticket links, ticket price, venue, status, and indexing behavior.
- REST JSON endpoint for public event data.
- Optional Schema.org Event/MusicEvent JSON-LD for public, indexable event pages.
- Schema.org admin fields for venue address, performer, organizer, ticket offer, attendance mode, and event status.
- Registered event meta fields with REST support and revision-aware storage where appropriate.
- Shared datetime meta synchronization for classic editor, REST saves, Visual Revisions fallback paths, and Pro imports.
- REST response caching with cache headers and debug information for administrators.
- SEO controls for hiding individual event pages and preventing indexing.
- Optional /events/ archive disable mode with a 301 redirect to a selected published page.
- Compatible event editing UI for both the block editor and classic editor, without duplicate meta storage.
- Classic theme template fallback for single event and archive templates.
Recurring events
GigRoute Events 2.0.0 adds parent recurring events for repeated shows, club nights, weekly performances, annual events, residencies, and other schedules where the same event repeats over time.
A parent recurring event stores the shared details and recurrence rule. Editors can generate dated occurrence posts with a one-time checkbox on update, so a normal save only stores recurrence settings and does not accidentally create or update event posts. Generated occurrences keep frontend lists, AJAX filters, REST requests, pagination, and Schema.org data working with normal event posts instead of calculating virtual dates on every request. Each sync is capped to protect the database from accidental daily schedules that span too far into the future.
Administrators can pause a recurring series to stop generating new occurrences, resume it later, or end it and choose whether future generated occurrences should be kept, cancelled, drafted, or moved to the trash. The Events admin list includes a recurrence filter and visual markers: parent recurring events are marked with a crown and generated occurrences have their own indicator. Individual occurrences show a direct link back to the parent event and can be detached when a specific date needs its own ticket link, ticket price, venue, status, or other event-specific data.
Gutenberg block
The GigRoute Events block lets editors display events without writing code. Block options include title, title tag, layout styling, number of events, event mode, ticket link visibility, grouping, pagination, filters, and date format.
This is useful for building conversion-focused sections such as “Tour Dates”, “Upcoming Shows”, “Live Events”, “Get Tickets”, or “Next Performances”.
Event posters
GigRoute Events includes poster functionality for visually promoting events. You can use individual event posters or one global poster across the site.
Poster settings include:
- Enable or disable posters globally.
- Use individual event posters or one global poster.
- Set the poster display delay.
- Hide the poster for a selected number of days after a visitor closes it.
- Wrap poster media in a link when a valid destination is available.
- Use the global poster link or the individual event Ticket URL as the destination.
This can help promote ticket campaigns, new tour announcements, stand-up specials, festival appearances, or other show business events.
REST API
GigRoute Events provides a public JSON endpoint:
/wp-json/gigroute-events/v1/events
The endpoint returns published events and supports event discovery, external frontends, mobile apps, landing pages, and custom JavaScript interfaces.
Supported query examples:
/wp-json/gigroute-events/v1/events
/wp-json/gigroute-events/v1/events?mode=upcoming
/wp-json/gigroute-events/v1/events?mode=all&year=2026
/wp-json/gigroute-events/v1/events?mode=all&year=2026&month=4
/wp-json/gigroute-events/v1/events?country=ukraine&city=kyiv&event_type=concert
/wp-json/gigroute-events/v1/events?start=2026-04-01&end=2026-04-30
/wp-json/gigroute-events/v1/events?mode=all&page=2&per_page=20
The response includes pagination data and event items. Empty values are removed from public event responses where possible. Event edit meta is registered for REST access, so block editor saves, revisions, integrations, and the classic editor all continue to work with the same underlying post meta keys instead of duplicated values.
SEO and marketing benefits
GigRoute Events helps structure event content in a way that supports marketing and organic discovery.
You can create dedicated content around live shows, city pages, tour schedules, artist announcements, and ticket calls to action. The plugin separates event metadata from normal post content, which makes it easier to reuse event information across blocks, templates, REST responses, filters, and promotional sections.
For SEO-focused event pages, you can use event titles, excerpts, content, featured images, event taxonomies, and location terms to create relevant pages around concerts, tours, stand-up shows, and entertainment events.
For events that should appear in lists but should not have a public single page, GigRoute Events includes event visibility controls. You can hide the direct event page and prevent search indexing while still keeping the event available in public lists and REST summaries when published.
External services
GigRoute Events can use the ipapi.co geolocation service when event-based posters are enabled on the frontend.
The service is used to request approximate visitor location data from:
https://ipapi.co/json/
The plugin uses this response to help choose a relevant upcoming event poster based on the visitor’s country, region, city, and approximate coordinates. The result may be cached in the visitor’s browser localStorage for up to 3 hours.
Data sent: the visitor’s browser makes a request to ipapi.co, which means the visitor’s IP address is processed by that external service.
Service terms: https://ipapi.co/terms/
Privacy policy: https://ipapi.co/privacy/