The events calendar shortcode
[wp_monthly_events]
Paste it into a page, a post, a Shortcode block, a text widget, or a page builder’s shortcode element (Elementor, Kadence, Avada, Divi and others). It shows the calendar in the default view chosen under Events Calendar → Settings.
Attributes
| Attribute | Values | Default | What it does |
|---|---|---|---|
view | month, list, day | Setting in Events Calendar → Settings | The view the calendar opens on. Visitors can still switch. |
category | A category slug, or several separated by commas | All categories | Shows only events in those categories (1.8+). |
Examples
Open on the month grid:
[wp_monthly_events view="month"]
Open on the upcoming events list (good for homepages):
[wp_monthly_events view="list"]
Open on today’s agenda:
[wp_monthly_events view="day"]
Show only one category, for example a calendar you imported from Google (1.8+):
[wp_monthly_events category="music"]
The Monthly Events Calendar block
In the block editor, add the Monthly Events Calendar block (Widgets category). Its sidebar has two settings: Default view, with the same choices as the view attribute, and Category (1.8+). More about the block
The Submit an Event shortcode and block
From 1.8, a second shortcode and block put an event submission form on a page:
[wp_monthly_events_submit]
| Attribute | What it does | Example |
|---|---|---|
hide | Leaves out optional fields: description, timezone, venue, category, website, image | hide="timezone,website" |
category | Puts every event from this form in one category | category="music" |
button | Button text | button="Send my event" |
redirect | Page on your site to go to after a successful submission | redirect="/thank-you/" |
Limits and tips
- One calendar per page. The block can only be inserted once, and only one shortcode per page is supported.
- Category calendars: use the
categoryattribute (1.8+). Every event category and tag also has its own page with a filtered calendar, at/events-category/your-category/and/events-tag/your-tag/by default. - Event archive:
/events/shows the calendar (1.6+), so you have a calendar page even without adding the shortcode. - Caching: the calendar loads events through the REST API after the page loads, so full-page caching won’t show stale events.
Coming from The Events Calendar?
Pages that use [tribe_events] keep working: while The Events Calendar is deactivated, Monthly Events Calendar shows its calendar in place of that shortcode (1.6+). The view values month, list and day carry over; other views open on the default. Switching guide