The default display is a month calendar grid. The month grid collapses to a CSS-styled list at phone screen sizes. You can use this view by setting
view="month" or omitting this parameter entirely.
By default the grid’s column labels will be the full names of the days of the week. For tighter layouts you can add
columnlabels="short" to use 3-letter abbreviations, or
columnlabels="min" to use 1- or 2-letter abbreviations. (The full day names and abbreviations are in the plugin’s translation files for all supported languages.)
You can display just the current week (with a selector to choose the previous and next week) in a grid style similar to month view by using
view="week". If desired, the selector can be hidden using custom CSS.
You can also display a fixed “week” (i.e. a short range of days) by adding
startdate="YYYYMMDD" and setting
limitdays="n" where n is the number of days. Use
startdate="today" to always start from the current date. (Maximum supported number of days in this view is 7.)
Deprecation notice: For backwards compatibility with earlier versions,
view="currentweek" is also supported and works interchangeably. This support may be removed in a future version.
To display upcoming events as a plain list on all screen sizes (which you can style with your own CSS), add
view="list" to the shortcode, with the optional
count="5" parameter to indicate the number of events to display. (By default, all upcoming events will be displayed.)
By default list view will display dates in the U.S. standard day-month-date format (e.g. “Thursday March 14”). To customize the format to your locale, you can use standard PHP date format strings with the
format parameter. For example, to use the day-month format (e.g. “14 March”), use
format="j F", or for an abbreviated numbered month/day format (e.g. “Thu 3/14”), use
There are additional views available in the Pro version, including month-with-sidebar, widget, year-with-sidebar, and more.
count parameter are supported in list view only. The
format parameter is supported in list view, and on the mobile breakpoint only for week and month views. The
startdate parameter is supported in week view only.