Events Global Settings

Overview

Events Global Settings live in the WordPress Customizer under the Events panel. They control permalink structure, date/time formatting across all event displays, and the event query cache.

Settings

  • Slug — permalink segment for single event URLs (default events); refresh permalinks after changing
  • Events Page — WordPress page used as the events index (dropdown)
  • Always show year? — include the year in date strings even for current-year events
  • Date Format — PHP date format for dates without year (default F j)
  • Date Format (with Year) — format when year is shown (default F j, Y)
  • Time Format — PHP time format (default g:i a)
  • Address Separator — string between address parts (default , )
  • Cache Time (Hours) — how long to cache event queries (0–24, default 3)
  • Cache Debug — log cache behavior for troubleshooting

Tips

  • Match Date Format strings to your site's editorial style — they apply in blocks, singles, and calendar tooltips.
  • Lower Cache Time during active editing; raise it on high-traffic production sites.

Settings

Events Global Settings

Slug

Permalink slug segment for single event URLs (default events). Visit Settings → Permalinks and save after changing so new URLs take effect.

Events Page (page selector)

WordPress page designated as the main events index. Used for breadcrumbs, redirects, and internal links to your schedule.

Always show year?

Always include the year in formatted event dates, even for events in the current year. Turn on when your schedule spans multiple years and you want every date to show the year.

Date Format

PHP date format for event dates without the year (default F j, e.g. June 23). Applies in blocks, singles, and calendar tooltips.

Address Separator

Characters inserted between address parts when city, state, and street are combined (default ", "). Change if your locale uses a different format.

Date Format (with Year)

PHP date format when the year is included (default F j, Y). Used when Always show year is on or when the event is in a different year.

Time Format

PHP time format for event start and end times (default g:i a, e.g. 7:00 pm). Matches WordPress date formatting conventions.