{"id":1957575,"date":"2022-09-06T03:51:59","date_gmt":"2022-09-06T07:51:59","guid":{"rendered":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/?post_type=post&#038;p=1952823"},"modified":"2025-09-02T06:59:38","modified_gmt":"2025-09-02T10:59:38","slug":"creating-a-recurring-event-2","status":"publish","type":"post","link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/creating-a-recurring-event-2\/","title":{"rendered":"Creating a Recurring Event"},"content":{"rendered":"\n<iframe loading=\"lazy\" width=\"560\" height=\"315\" src=\"https:\/\/www.youtube.com\/embed\/JqbrUdWWaOE?si=5L4OXbA92CiwsRYq\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen><\/iframe>\n\n\n\n<p>One of the most popular features of <a href=\"https:\/\/theeventscalendar.com\/product\/wordpress-events-calendar-pro\/\" target=\"_blank\" rel=\"noreferrer noopener\">Events Calendar Pro<\/a> is the ability to create recurring events. For example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A cooking class that happens every week on Wednesday for 10 weeks<\/li>\n\n\n\n<li>Summer camp every day from 9 am to 1 pm for a week<\/li>\n\n\n\n<li>A board meeting that is always on the second Friday of the month<\/li>\n\n\n\n<li>Holiday celebration that occurs on the same day every year<\/li>\n\n\n\n<li>School exams that repeat multiple times but without a particular pattern<\/li>\n<\/ul>\n\n\n\n<p>All of these scenarios are possible with recurring events. However, note that you can only add <strong>one recurrence pattern per event<\/strong>. For more complex patterns, you can group together multiple recurring events in a <a href=\"#h-using-series-with-recurring-events\" target=\"_blank\" rel=\"noreferrer noopener\">Series<\/a>. You can always add any number of single, date-based recurrences. <br><br>This guide will show how to use this functionality in detail. If you&#8217;re not familiar with how to create regular single events, please review <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/creating-an-event\/\" target=\"_blank\" rel=\"noreferrer noopener\">our guide<\/a> before continuing.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"getting-started\">Getting Started with Recurring Events<\/h2>\n\n\n\n<p>Let&#8217;s begin with the <strong>Time &amp; Date<\/strong> settings for your event. If you are converting an existing single event into a recurring event, you have already set the start and end for the single event. If you&#8217;re creating a recurring event from scratch, the first options set the start and end for the first occurrence. The first occurrence will also dictate what kinds of pattern options are available.<\/p>\n\n\n\n<p>If you&#8217;re working in the classic editor, you&#8217;ll see an option to <strong>Schedule multiple events<\/strong>. &nbsp;This option is located just below the <strong>Start\/End<\/strong> options for your event.<\/p>\n\n\n\n<iframe loading=\"lazy\" width=\"560\" height=\"315\" src=\"https:\/\/www.youtube.com\/embed\/QG85h8Ow634\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen=\"\"><\/iframe>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/07\/Screen-Shot-2022-07-27-at-7.08.33-AM.png\" alt=\"Create a recurring event\" class=\"wp-image-1953773\"\/><figcaption class=\"wp-element-caption\">Time and Date in Classic Editor<\/figcaption><\/figure>\n\n\n\n<p>Click the <strong>Schedule multiple events<\/strong> button to display the first set of options for your additional events. You&#8217;ll then see a dropdown with the various recurrence types.<\/p>\n\n\n\n<p>In Block Editor, things will look just a little bit different. Click <strong>Repeat this Event<\/strong> to open the recurrence options.<\/p>\n\n\n\n<iframe loading=\"lazy\" width=\"560\" height=\"315\" src=\"https:\/\/www.youtube.com\/embed\/UoTYiuPv3wY\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen=\"\"><\/iframe>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/05\/Screen-Shot-2022-05-12-at-12.48.34-PM.png\" alt=\"Time and Date in Block Editor\" class=\"wp-image-1952825\"\/><figcaption class=\"wp-element-caption\">Time and Date in Block Editor<\/figcaption><\/figure>\n\n\n\n<p>For recurring events that conform to a regular pattern, select the option that applies to your recurring event (<strong>Daily<\/strong>, <strong>Weekly<\/strong>, <strong>Monthly<\/strong>, or <strong>Yearly<\/strong>). If your event occurs on specific dates without following an established pattern, select the <strong>Once<\/strong> option for your event. We&#8217;ll go over the options for both patterned and non-patterned recurrences below.<\/p>\n\n\n\n<p class=\"has-text-color has-background\" style=\"color:#141827;background-color:var(--global-palette8)\">\ud83d\udc4b <strong>Note:<\/strong> Creating tickets for recurring events is not currently supported at this time. Learn more <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/recurring-events-and-tickets\/\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"pattern-series\">Patterned Recurring Events<\/h2>\n\n\n\n<p>When you pick an option from the <em>Happens <\/em>dropdown, more fields will appear:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/08\/classic-monthly-rule-1024x314.png\" alt=\"\" class=\"wp-image-1953797\"\/><figcaption class=\"wp-element-caption\">A monthly recurring event in the classic editor<\/figcaption><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/08\/block-yearly-rule-1024x575.png\" alt=\"\" class=\"wp-image-1953798\"\/><figcaption class=\"wp-element-caption\">A yearly recurrence rule in the block editor <\/figcaption><\/figure>\n\n\n\n<p>You can use those additional options to set the exact pattern you need for your event, for example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>An event that recurs every three days<\/li>\n\n\n\n<li>A weekly event that recurs every week on Tuesdays and Thursdays<\/li>\n\n\n\n<li>A monthly event that always falls on the first Friday of the month<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-ending-a-recurrence-pattern\">Ending a Recurrence Pattern<\/h2>\n\n\n\n<p>The <em>Ends <\/em>option allows you to dictate when a given recurrence pattern will stop repeating. The default option is <strong>ends never, <\/strong>which means that your event will repeat for up to 60 months in the future (aka 5 years).<\/p>\n\n\n\n<p>Setting the <strong>End <\/strong>option to <strong>end<\/strong> <strong>on<\/strong> <strong>a given date<\/strong> lets you specify the last possible date an event from the sequence can take place. Example:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You create an event starting Wednesday, October 4<\/li>\n\n\n\n<li>It recurs every week ending <strong>on<\/strong> Wednesday, October 25<\/li>\n\n\n\n<li>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<\/li>\n\n\n\n<li>If you selected Tuesday, October 24, then the last instance of the event would take place on the preceding Wednesday (October 18) instead<\/li>\n<\/ul>\n\n\n\n<p>You can also set the pattern to <strong>end<\/strong> <strong>after<\/strong> <strong>a specific number of occurrences<\/strong>. For example, an event that happens every month and ends after 12 events will recur each month for a year.<\/p>\n\n\n\n<p>In other words, the <strong>on<\/strong> and <strong>after<\/strong> options let you distinguish between inclusive and exclusive date ranges.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full alignnone\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/07\/Screen-Shot-2022-07-27-at-7.13.09-AM.png\" alt=\"Recurring event \" class=\"wp-image-1953775\"\/><figcaption class=\"wp-element-caption\">Recurrence Rules in Classic Editor<\/figcaption><\/figure>\n\n\n\n<p>Selecting the <strong>Never <\/strong>option means that events will be created up to 60 months (5 years) after the initial event&#8217;s date. You can change that value and limit the number of events created by using the <code>tribe_get_option_recurrenceMaxMonthsAfter<\/code> filter.<\/p>\n\n\n\n<p>To change the limit please paste this snippet within your themes <code>function.php<\/code> file or using this handy&nbsp;<a href=\"https:\/\/wordpress.org\/plugins\/code-snippets\/\" target=\"_blank\" rel=\"noreferrer noopener\">Code Snippets plugin<\/a>. You can learn more about using custom code snippets in our&nbsp;<a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/best-practices-for-implementing-custom-code-snippets\/\" target=\"_blank\" rel=\"noreferrer noopener\">knowledegebase<\/a>.<br><\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: css; title: ; notranslate\" title=\"\">\n\/\/ Add the tribe_get_option_recurrenceMaxMonthsAfter filter\nfunction custom_recurrence_max_months( $value ) {\n    return 120;\n    \/\/change this number to whatever your desired number of max recurrence months is\n}\nadd_filter( &#039;tribe_get_option_recurrenceMaxMonthsAfter&#039;, &#039;custom_recurrence_max_months&#039; );\n<\/pre><\/div>\n\n\n<figure class=\"wp-block-image size-full alignnone wp-image-1944170\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/07\/Screen-Shot-2022-07-27-at-7.18.30-AM.png\" alt=\"Recurrence Rules in the block Editor\" class=\"wp-image-1953779\"\/><figcaption class=\"wp-element-caption\">Recurrence Rules in Block Editor<\/figcaption><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p>Remember, <strong>you can only add one pattern-based rule per event<\/strong>*. If you have a more complex event, you can use the <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/event-series\/\" target=\"_blank\" rel=\"noreferrer noopener\">Series<\/a> feature to group several recurring events together. You can also add as many individual occurrences to a recurring event using the <em><strong>Once <\/strong><\/em>option.  <\/p>\n\n\n\n<p>You can remove a set of recurrence rules at any time by clicking the trash can icon to the right.<\/p>\n\n\n\n<p class=\"has-small-font-size\"><em>* For managing recurring events we follow the <a href=\"https:\/\/icalendar.org\/iCalendar-RFC-5545\/3-8-5-3-recurrence-rule.html\" target=\"_blank\" rel=\"noreferrer noopener\">iCalendar standard<\/a>, which allows only one pattern-based rule per event.<\/em><\/p>\n\n\n\n<p class=\"has-text-color has-background\" style=\"color:#141827;background-color:var(--global-palette8)\">\ud83d\udc4b <strong>Note:<\/strong> Performance issues may arise if the date of the recurring events is far in the future. To avoid performance problems, we advise against having a lot of recurring events that end in the far future.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"non-pattern-series\">Non-patterned Recurrence<\/h2>\n\n\n\n<p>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 <strong>Once<\/strong> recurrence type. You can add as many of these manual recurrences to your event as you want. <\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/07\/Screen-Shot-2022-07-27-at-7.14.07-AM.png\" alt=\"Recurring event that happens once\" class=\"wp-image-1953776\"\/><figcaption class=\"wp-element-caption\">Non-patterned recurring event options in classic editor<\/figcaption><\/figure><\/div>\n\n\n<figure class=\"wp-block-image size-full alignnone wp-image-1944171\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/07\/Screen-Shot-2022-07-27-at-7.19.12-AM.png\" alt=\"Non-Pattern-Based Recurring Events in Block Editor\" class=\"wp-image-1953780\"\/><figcaption class=\"wp-element-caption\">Non-patterned recurring event options in block editor<\/figcaption><\/figure>\n\n\n\n<p>Enter the date for your event into the <strong>On<\/strong> field by typing or by using the provided date picker.  <\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"exclusions\">Exceptions<\/h2>\n\n\n\n<p>You can also exclude days or dates within a recurring event by using an <strong>Exception.<\/strong> For example, if you have an event that happens weekly on Fridays, you could choose to exclude the third Friday of every month. The recurring event would not appear on your calendar every third Friday. <\/p>\n\n\n\n<p>The <strong>Add Exception<\/strong> option will appear as soon as you add any other recurrence rules. You can exclude occurrences based on a pattern, or choose individual dates.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/07\/Screen-Shot-2022-07-27-at-7.15.11-AM.png\" alt=\"Add exception\" class=\"wp-image-1953777\"\/><figcaption class=\"wp-element-caption\">Recurring Event Exceptions in Classic Editor<\/figcaption><\/figure><\/div>\n\n\n<figure class=\"wp-block-image size-full alignnone wp-image-1944172\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/07\/Screen-Shot-2022-07-27-at-7.19.51-AM.png\" alt=\"Recurring Event Exceptions in Block Editor\" class=\"wp-image-1953781\"\/><figcaption class=\"wp-element-caption\">Recurring Event Exceptions in Block Editor<\/figcaption><\/figure>\n\n\n\n<p>You can only have one pattern-based exception per event, but you can add as many single\/once exceptions as you&#8217;d like. You can delete exceptions by clicking the trash can icon to the right of any row.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-finalizing-your-recurring-event\">Finalizing Your Recurring Event<\/h2>\n\n\n\n<p>Once you have set a recurrence pattern and\/or added individual occurrences with the <strong>Once <\/strong>option, you can save the event. When you save, the recurring event occurrences will be created. If your event was not already in a Series, a new <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/event-series\/\" target=\"_blank\" rel=\"noreferrer noopener\">Series<\/a> will also be generated as part of the recurring event save process.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"display\">Display Settings<\/h2>\n\n\n\n<p>Let&#8217;s imagine that you have a class that takes place every weekday evening&#8211;indefinitely.<\/p>\n\n\n\n<p>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&#8217;t want each page to be many events that are identical except for the difference in the start date.<\/p>\n\n\n\n<p>To avoid this situation, you can condense events in list-style views for all but the <em>first upcoming<\/em> event in Series. You&#8217;ll find this setting under <strong>Events<\/strong> &gt; <strong>Settings<\/strong> in the <strong>General<\/strong> tab (which is selected when you first navigate to your plugin settings).<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2023\/05\/condense.png\" alt=\"\" class=\"wp-image-1955193\"\/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-using-series-with-recurring-events\">Using Series with recurring events<\/h2>\n\n\n\n<p>If you have events that recur with multiple patterns (e.g. monthly on the first Tuesday and the third Wednesday) then you can use a <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/event-series\/\" target=\"_blank\" rel=\"noreferrer noopener\">Series<\/a>. With event Series, you can group and manage multiple events. A Series can include any number of single or recurring events.  <\/p>\n\n\n\n<p>When you create a recurring event and don&#8217;t assign it to a Series, a new Series of the same name will be created when you first publish the event. If you want to create an event with a different recurrence pattern in the same Series, you can do that by <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/duplicate-events\/\" target=\"_blank\" rel=\"noreferrer noopener\">duplicating<\/a> the recurring event and then adjusting the recurrence rules. Both events will be in the same Series, so they&#8217;ll be displayed together on the Series landing page. <\/p>\n\n\n\n<p>For more information on Series, see <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/event-series\/\" target=\"_blank\" rel=\"noreferrer noopener\">this Knowledgebase article<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"final\">Final Thoughts<\/h2>\n\n\n\n<p>We have aimed to make recurring events as intuitive an experience as possible. We hope that this article will serve as a useful reference for the options available to you! If you should get stuck or need any further help, please don&#8217;t hesitate to post to&nbsp;<a href=\"https:\/\/support.theeventscalendar.com\/submit_ticket\" target=\"_blank\" rel=\"noreferrer noopener\">our help desk<\/a> and let us know.<\/p>\n\n\n\n<p>Good luck!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>One of the most popular features of Events Calendar Pro is the ability to create recurring events. For example: All of these scenarios are possible with recurring events. However, note that you can only add one recurrence pattern per event. For more complex patterns, you can group together multiple recurring events in a Series. You&#8230;<\/p>\n","protected":false},"author":34,"featured_media":1955565,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"ep_exclude_from_search":false,"footnotes":""},"categories":[67],"tags":[66],"stellar-product-taxonomy":[158],"class_list":["post-1957575","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-recurring-events","tag-recurring","stellar-product-taxonomy-events-calendar-pro"],"acf":[],"taxonomy_info":{"category":[{"value":67,"label":"Recurring Events"}],"post_tag":[{"value":66,"label":"recurring"}],"stellar-product-taxonomy":[{"value":158,"label":"Events Calendar Pro"}]},"featured_image_src_large":["https:\/\/images.theeventscalendar.com\/kb\/uploads\/2023\/02\/social-share-1024x538.png",1024,538,true],"author_info":{"display_name":"jaimem","author_link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/author\/jaimem\/"},"comment_info":0,"category_info":[{"term_id":67,"name":"Recurring Events","slug":"recurring-events","term_group":0,"term_taxonomy_id":67,"taxonomy":"category","description":"","parent":61,"count":11,"filter":"raw","term_order":"0","cat_ID":67,"category_count":11,"category_description":"","cat_name":"Recurring Events","category_nicename":"recurring-events","category_parent":61}],"tag_info":[{"term_id":66,"name":"recurring","slug":"recurring","term_group":0,"term_taxonomy_id":66,"taxonomy":"post_tag","description":"","parent":0,"count":5,"filter":"raw","term_order":"0"}],"_links":{"self":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1957575","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/users\/34"}],"replies":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/comments?post=1957575"}],"version-history":[{"count":5,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1957575\/revisions"}],"predecessor-version":[{"id":1966647,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1957575\/revisions\/1966647"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media\/1955565"}],"wp:attachment":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media?parent=1957575"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/categories?post=1957575"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/tags?post=1957575"},{"taxonomy":"stellar-product-taxonomy","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/stellar-product-taxonomy?post=1957575"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}