Gig Listings & Shortcodes
Display your gigs on any page with a simple shortcode. Filter by date, year, or artist.
Basic usage
Add the following shortcode to any WordPress page or post to display your full gig listing — upcoming shows first, then past shows below:
[pb_gig_diary]
Upcoming gigs are sorted soonest first. Past gigs are sorted most recent first, with a Load more button appearing if you have more than 30 past gigs.
Shortcode options
| Option | Example | Description |
|---|---|---|
| upcoming_only | [pb_gig_diary upcoming_only="yes"] | Show upcoming gigs only — no past gigs section |
| past_only | [pb_gig_diary past_only="yes"] | Show past gigs only — no upcoming section |
| count | [pb_gig_diary count="5"] | Limit upcoming gigs to the next 5 |
| year | [pb_gig_diary year="2025"] | Show only gigs from a specific year |
| artist | [pb_gig_diary artist="my-band"] | Filter by artist slug — Agency licences only |
Options can be combined — for example, to show only the next 3 upcoming gigs:
[pb_gig_diary upcoming_only="yes" count="3"]
What each gig displays
Each gig in the listing shows the following information:
| Item | Notes |
|---|---|
| Date | Always shown |
| Time | Shown if set on the gig |
| Venue name & address | Always shown. Venue name links to venue website if set. |
| Map link | Shown if venue has an address. Opens Google Maps. |
| Status badge | Provisional badge shown in amber. Cancelled shown with strikethrough. |
| Age restriction | Shown if set on the gig |
| Admission | Shown if set and not “Free” |
| Phone | Shown if set on the venue |
| Notes | Public notes from the gig form |
| View setlist → | Shown if the gig has a public setlist (Studio+) |
Repertoire shortcode
Display your full song catalogue on any page with:
[pb_artist_repertoire]
This shows all active songs with title, original artist, year, key, and duration columns. Requires a Studio licence or above.
Control which columns appear using these parameters:
| Parameter | Default | Description |
|---|---|---|
show_original | yes | Show or hide the Original Artist column |
show_year | yes | Show or hide the Year column |
show_key | yes | Show or hide the Key column |
show_duration | yes | Show or hide the Duration column |
year_from | — | Only show songs released from this year onwards |
year_to | — | Only show songs released up to this year |
artist | — | Filter by artist slug (Agency licences) |
For a themed show — e.g. an all-60s set:
[pb_artist_repertoire year_from="1960" year_to="1969" show_key="no" show_duration="no"]
Songs without a release year set will be excluded when year filtering is active.
Setlist shortcode
Embed a specific gig’s setlist on any page:
[pb_artist_setlist gig_id=123]
Replace 123 with the ID of the gig. You can find the gig ID in the URL when editing a gig in WordPress admin. Requires a Studio licence or above.
Styling your gig listings
PB Gig Diary’s public listings use minimal styling that inherits from your theme. With a Pro licence or above, you can customise colours, fonts, and layout via Gig Diary → Settings → Style — no code required.
For more advanced customisation, all elements have CSS classes prefixed with gd- so you can target them in your theme stylesheet.
RSS and iCal feeds
PB Gig Diary automatically generates RSS and iCal feeds for your gig listings. Links to both feeds appear at the bottom of every gig listing page. The iCal feed can be subscribed to directly in Google Calendar, Apple Calendar, or any calendar app that supports iCal URLs.