While most calendar events are single one-day or multi-day events, there may be times when a group of events known as recurring events, may be more appropriate. For example:
- Events that repeat on an interval, such as weekly cooking classes
- Events of the same type that don’t follow a regular pattern, such as test dates for a school calendar
To accommodate for scenarios like this, Events Calendar Pro provides powerful recurrence capabilities. This guide will show how to use this functionality in detail.
If you’re not familiar with how to create events, please review our guide before continuing.
Getting Started with Recurring Events #
???? Note: Creating tickets for recurring events is not fully supported at this point. Tickets need to be created separately for each and every recurrence.
Let’s begin with the Time & Date settings for your event. This applies whether you’re converting an existing single event into a recurring event or creating a group of events from scratch.
With recurring events, the first occurrence of your event will reflect the options chosen for Start/End under this heading. That is the same as creating a single event. Be sure that you’ve specified the correct start date, end date, and start and end times for the first event before proceeding.
After making your selections for the first event, you’ll see an option to Schedule multiple events. This option is located just below the Start/End options for your event.
Classic Editor Start/End Time & Date
Click the Schedule multiple events button to display the first set of options for your additional events. You’ll see a row of buttons denoting the available recurrence types for your recurring events.
In Block editor, things will look just a little bit different. Click Repeat this Event to open the recurrence options.
For recurring events that conform to a regular pattern, select the option that applies to your recurring event (Daily, Weekly, Monthly, or Yearly). If your event occurs on specific dates without following an established pattern, select the Once option for your event. We’ll go over the options for both pattern-based and non-pattern-based recurrences below.
Pattern-Based Recurring Events #
Once you’ve picked the option that works best for your event, more fields will appear, as shown below:
Let’s use the Daily event recurrence options as an example. All pattern-based recurrence types will default to the most basic type of recurrence. In this case, that’s an event that recurs daily, at the same time as the original event. You can tailor this pattern even further if needed. For example, you might wish to have:
- An event that recurs every three days
- A weekly event that recurs every week on Tuesdays and Thursdays
- A monthly event that always falls on the first Friday of the month.
Each of these patterns can be made with Events Calendar Pro’s recurring events features.
Setting the pattern to end on a given date lets you specify the last possible date an event from the sequence can take place on. Example:
- You create an event starting Wednesday, October 4, 2017
- It recurs every week ending on Wednesday, October 25, 2017
- That final date is when the last event in the sequence will take place, not to be confused with the end date of the event itself
- If you selected Tuesday, October 24, 2017, then the last instance of the event would take place on the preceding Wednesday (October 18) instead
By contrast, if you set the pattern to end after a certain date, the next logical date will be used as the final date. To extend our previous example, that means setting the pattern to end after October 25 would mean the last date in the pattern would be October 25.
In other words, the on and after options let you distinguish between inclusive and exclusive date ranges. Selecting the never option means that events will be created indefinitely as dictated by your Recurrence Settings.
⚠ It is possible to create a recurring event with no end date for the event to stop recurring. Please note that doing so will set the event to recur indefinitely. This will create an indefinitely growing number of events posts in the calendar. Indefinitely growing events can have a negative effect on the calendar’s performance. Your calendar may load or react slowly based on the number of events that are present in the calendar.
If you’re setting up a regular recurrence pattern, such as an event that occurs on a monthly pattern without exceptions, then you are all done! Scroll up until the Publish pane is visible on the right side of the page, then click the blue Publish or Update button to save your event.
If you want a more complicated recurring event, read on! And remember, you can set as many recurrence rules as you need. Click the Add more events button once you’re finished with a set of recurrence rules to expand the next set of options. You can remove a set of recurrence rules at any time by clicking the trash can icon to the right of the desired row.
Never-Ending & Long-Term Recurrence Patterns #
In certain cases, you may have an event that will repeat constantly with no known end date, and you may not wish to specify one. Or you may have an event that will repeat for a long time–perhaps even a few years. Both of these are fully supported by Events Calendar Pro, but it’s important to understand how this works behind the scenes.
Since every event has a corresponding entry in the database, a never-ending event could equate to an infinite number of database entries. This isn’t feasible–the last thing we want is to blow up your database! Similarly, a long-term recurrence pattern with hundreds of instances could place a significant burden on your database, slowing your site and events down considerably.
Rather than following this approach, we create events ahead of time as needed and clean up old events within a buffer period. By default, this period extends 2 years from today in both directions, meaning that:
- Recurring events that are more than 2 years in the past will be automatically removed
- Each day, any additional events that need to be created to ensure there are 2 years’ worth of future events will be automatically generated
When you create an event with a long-term or never-ending recurrence pattern, you’ll see a notice that looks something like this:
That number shows you how many instances of your event have been created (as controlled by your buffer period). As time passes, old events will be deleted and new ones will be made as defined by your recurrence pattern.
In certain cases, you may need to extend or shorten the buffer period for your recurrring event. You’ll find these settings under Events > Settings in the General tab (which is selected when you first navigate to your plugin settings).
Please note that changing these settings will not change event instances that have already been created. Any changes made will affect new events or event instances created from that point forward.
Non-Pattern-Based Rules #
If your recurring event includes one or more event instances that do not occur as part of a greater pattern, you can add these events to your recurring event by using the Once recurrence type. Clicking this button when adding a recurrence rule to your event will display the following options.
Enter the date for your event into the On field by typing or by using the provided date picker. You can also specify whether this event will occur at the same or different time as the original event. Once you’ve finished providing the details for your first event recurrence, you may add other rules as needed. Just select the Add more events button. You can remove a set of recurrence rules at any time by clicking the trash can icon to the right of the desired row. After you’ve entered the recurrence rules for all of your event dates, you can save your changes by scrolling up until the Publish pane is visible on the right side of the page, then clicking the blue Publish or Update button.
You can exclude specific dates or ranges within a recurring event. An Add Exclusion button will appear as soon as you add any other recurrence rules. Clicking this will display a row of buttons matching those that appear when adding a new recurrence rule. You can use the Daily, Weekly, Monthly, or Yearly exclusion options to exclude events in a pattern-based recurring event. You can use the Once exclusion option to exclude a single event on a specific date.
Add as many exclusions as you need to fine-tune your recurring event. You can delete exclusions by clicking the trash can icon to the right of any row.
Display Settings #
Let’s imagine that you have a class that takes place every weekday evening–indefinitely.
If you have many such recurring events, you will quickly end up with a very busy calendar. This could be particularly confusing to users accessing your events in list-style views. For example, if you only want 20 events to show per page, you don’t want each page to be many events that are identical except for the difference in the start date.
To avoid this situation, you can hide recurring events from list-style views for all but the first upcoming event in each sequence. You’ll find this setting under Events > Settings in the General tab (which is selected when you first navigate to your plugin settings).
Breaking Events Out #
So far, we’ve covered how to create recurring event instances on your site. What if you want to go the other way and break a single instance of an event out of the group? This is a handy feature when life introduces changes to event plans. For example, you want to push one instance of an event an hour back while leaving the rest unaltered. Breaking events out from the recurring event is the feature you’re looking for.
There are two methods for breaking events out of the group:
- Breaking off a single instance of an event
- Breaking off a batch of events from a given start date.
Let’s cover the single instance method first.
Breaking off a Single Event #
When you are viewing an instance of an event on your site, if you have the Toolbar enabled in your WordPress user settings, you should see an Edit Event link in the toolbar. Upon hovering over this link, a drop-down menu should appear with a few options. Select Break from Series.
Click this link and allow the page to refresh. You should be brought to the edit screen for this event in your WordPress admin. The event will no longer be a part of the recurring event.
Breaking off a Batch of Events #
The above method covers breaking off one singular event from the group. This second method doesn’t break off just one event. It splits the main recurring event in two, leaving two separate recurring events.
To do this, navigate to Events from your WordPress sidebar. In your listing of events, locate the event where you want to split up. Hover over the title of this event and look for the Edit Upcoming link.
Click this link to confirm that you’d like to split your recurring events at this location. You’ll see a pop-up dialog box confirming the change before it is processed.
Click OK to confirm, and your recurring events will be split at this event.
When might splitting your recurring events in this manner be useful? Let’s say you have an event that runs for a whole year. It happens every Friday at 7pm. Then, about four months into the year, things change, and the event gets shifted back to 8pm every Friday. For example, if the change is going into effect on April 1st, you could go to the April 1st event and use the Edit Upcoming feature to make this event and every event after it start at 8pm instead of 7pm.