Search Events

My Calendar includes a simple search form that can be used in a few different ways. The main parameter for the search form is a target URL. By default, searches will be targeted to the main My Calendar page, where your calendar is displayed. In that case, they’ll display in whatever default view your calendar uses.

If you target a URL that does not contain the my_calendar shortcode, then the results will display in a numbered list showing the events that match the search in date order from soonest to farthest out.


The search widget is documented on the widgets page.


You can insert the search form using the shortcode [my_calendar_search url=""]

My Calendar Navigation

The search can be added as a navigation item above or below the calendar’s main view. This method only queries the calendar view. Use the key search to insert it in the main My Calendar shortcode.


Widgets are located under Appearance > Widgets or in the Appearance > Customize > Widgets section.

Widgets do not provide different functionality than shortcode functions, but they do make it easier to implement secondary calendars.

Block Widgets

Block widgets are used in the Core Editor (Gutenberg).

Appearance > Widgets.
Add widget blocks by clicking the top left blue square with a + in it to open the block inserter. (The blue square changes to black when open.)
The block inserter area looks like this.

Block Widgets

Widget overview

Widgets are pictured using the block widget interface, but are also available in the classic widget interface.

My Calendar: Today’s Events

Today’s Events

My Calendar: Upcoming Events

Upcoming Events

My Calendar: Mini Calendar

My Calendar: Mini Calendar block widget

My Calendar: Simple Event Search

Simple Event Search

My Calendar: Event Filters

Event Filters

Appearance > Customize
Have the same block widgets as are seen in the Widgets screen.
Here is an example using the My Calendar: Mini Calendar.

Customize – widgets – Mini Calendar