Settings
Configure PB Gig Diary — artist details, defaults, Google Calendar, and more.
All settings are found under Gig Diary → Settings in your WordPress admin. Settings are organised into tabs across the top of the page.
General tab
The General tab covers your artist identity and defaults that apply across the whole plugin.
| Field | Notes |
|---|---|
| Artist / band name | Required. Used in page headings, feed titles, and Google Calendar event summaries. |
| Artist slug | A URL-friendly version of your band name — lowercase letters, numbers, and hyphens only. Used in shortcodes to filter by artist e.g. [pb_gig_diary artist="the-moonrocks"]. Generated automatically but can be edited. |
| Default country | Pre-filled on new venue forms. Saves time if most of your venues are in the same country. |
| Default age restriction | Pre-filled on new gig forms — e.g. All Ages/Licensed. Can be changed per gig. |
| Band members | Comma-separated names — e.g. Brian F, John, Brian P. Used to populate unavailability entries so you can record which member is unavailable for a date. |
| Default gap between songs | Seconds between each song in the setlist timing calculator. Can be overridden per gig. Default is 30 seconds. |
| Default break between sets | Minutes between sets in the timing calculator. Can be overridden per gig. Default is 15 minutes. |
Shortcodes reference
The bottom of the General tab shows a quick reference of all available shortcodes for your install, with your artist slug already filled in. This is a handy reference when adding shortcodes to your website pages.
| Shortcode | Description |
|---|---|
[pb_gig_diary] | Full upcoming and past gig listing |
[pb_gig_diary artist="slug"] | Filter by artist slug |
[pb_gig_diary count="5"] | Next 5 upcoming gigs only |
[pb_gig_diary upcoming_only="yes"] | Upcoming shows only, no past section |
[pb_gig_diary past_only="yes"] | Past shows only |
[pb_gig_diary year="2025"] | All gigs in a specific year |
[pb_gig_diary_next] | Next upcoming gig only — useful for homepages |
[pb_artist_repertoire] | Full song repertoire for the artist |
[pb_artist_repertoire show_year="no" show_key="no" show_duration="no"] | Repertoire with titles and original artists only |
[pb_artist_repertoire year_from="1960" year_to="1969"] | Songs from a specific decade |
[pb_artist_setlist gig_id="123"] | Embed a specific gig’s public setlist on any page |
Parameters can be combined — e.g. [pb_gig_diary count="3" upcoming_only="yes"]. See Gig listings & shortcodes for the full parameter reference.
Feeds
The General tab also shows the RSS and iCal feed URLs for your gig listings. These are generated automatically — share the iCal URL with band members so they can subscribe to your gig calendar directly in Google Calendar, Apple Calendar, or any other calendar app.
Google Calendar tab
Connect PB Gig Diary to a Google Calendar so that gigs are created, updated, and deleted in your calendar automatically. Requires a Starter licence or above. See Google Calendar sync for full setup instructions.
Import tab
Bulk import gigs, venues, artists, or songs from a CSV file. Requires a Pro licence or above. See Import / Export for full details.
Export tab
Export your gigs, venues, artists, or songs as CSV files for backup or migration purposes. Requires a Pro licence or above. See Import / Export for full details.
Style tab
Customise the appearance of your public gig listings — colours, fonts, font size, and layout — without writing any CSS. Requires a Pro licence or above. For more advanced customisation, see CSS class reference.
Licence tab
Enter and manage your licence key, view your current tier and update entitlement expiry, and deactivate your licence if you’re moving to a new server. See Managing your licence for full details.