Skip to content
WordPress Events Calendar
  • FeaturesExpand
    • Monthly calendar viewColour-coded month grid
    • List viewUpcoming events in order
    • Daily agenda viewOne day on a timeline
    • Event managementDates, venues and colours
    • Venues and organizersSave once, reuse anywhere
    • Timezones and all-day eventsThe right time for everyone
    • Gutenberg blockBlock or one shortcode
    • Add to CalendarGoogle, Apple and Outlook
    • Categories and tagsGroup, filter and colour
    • Google Calendar importImport and sync iCal feeds
    • Event submissionsVisitors send their events
  • Live Demo
  • DocsExpand
    • InstallationUp and running in minutes
    • Creating eventsDates, times, venues, images
    • Shortcode and blockEvery option explained
    • Switch from The Events CalendarBring your events across
    • Import a calendarGoogle, Outlook, Apple, .ics
    • TroubleshootingFix common problems
    • Event submissionsForm, approval and popup
    • Page buildersElementor, Divi, Avada and more
    • TranslationYour language, Loco Translate
    • DevelopersHooks, REST API, templates
  • CompareExpand
    • vs The Events Calendar
    • vs Modern Events Calendar
    • vs Sugar Calendar
  • Blog
  • Download free
WordPress Events Calendar

Home / Docs / Shortcode and block

Shortcode and Block Reference

Monthly Events Calendar has one events calendar shortcode, [wp_monthly_events], and one block. Both show the same interactive calendar; this page lists every option.

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

AttributeValuesDefaultWhat it does
viewmonth, list, daySetting in Events Calendar → SettingsThe view the calendar opens on. Visitors can still switch.
categoryA category slug, or several separated by commasAll categoriesShows 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]
AttributeWhat it doesExample
hideLeaves out optional fields: description, timezone, venue, category, website, imagehide="timezone,website"
categoryPuts every event from this form in one categorycategory="music"
buttonButton textbutton="Send my event"
redirectPage on your site to go to after a successful submissionredirect="/thank-you/"

Set up event submissions

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 category attribute (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

WordPress Events Calendar
  • Switch from The Events Calendar
  • About
  • Changelog
  • Roadmap
  • Support
  • Contact

© 2026 WP Monthly Events

Scroll to top
  • Features
    • Monthly calendar viewColour-coded month grid
    • List viewUpcoming events in order
    • Daily agenda viewOne day on a timeline
    • Event managementDates, venues and colours
    • Venues and organizersSave once, reuse anywhere
    • Timezones and all-day eventsThe right time for everyone
    • Gutenberg blockBlock or one shortcode
    • Add to CalendarGoogle, Apple and Outlook
    • Categories and tagsGroup, filter and colour
    • Google Calendar importImport and sync iCal feeds
    • Event submissionsVisitors send their events
  • Live Demo
  • Docs
    • InstallationUp and running in minutes
    • Creating eventsDates, times, venues, images
    • Shortcode and blockEvery option explained
    • Switch from The Events CalendarBring your events across
    • Import a calendarGoogle, Outlook, Apple, .ics
    • TroubleshootingFix common problems
    • Event submissionsForm, approval and popup
    • Page buildersElementor, Divi, Avada and more
    • TranslationYour language, Loco Translate
    • DevelopersHooks, REST API, templates
  • Compare
    • vs The Events Calendar
    • vs Modern Events Calendar
    • vs Sugar Calendar
  • Blog
  • Download free