The Events Calendar

ཞིབ་བརྗོད།

Easily create and manage an events calendar on your WordPress site with The Events Calendar free plugin. Whether your events are in-person or virtual events, this WordPress calendar plugin boasts professional features backed by our world-class team of developers and designers.

See more videos on our YouTube channel

Packed with loads of features, The Events Calendar is ready to go out of the box. It’s also extensible, easy to use, and completely customizable.

📅 The #1 Calendar for WordPress

See the calendar in action on our demo experience. Just getting started? Read through the New User Primer to get set up.

Looking for additional features like recurring events, ticket sales, user-submitted events, automatic imports, and more?

Check out Events Calendar Pro, Event Aggregator, and more add-ons.

🔌🎨 Plug and Play or Customize

The Events Calendar is built to work out of the box. Simply install the plugin, configure your settings, and start creating events in minutes.

Want to add your personal touch? Use The Events Calendar as the foundation for customization. Personalize to your heart’s content with the help of a skeleton stylesheet, partial template overrides, template tags, hooks and filters, careful documentation, and a library of free extensions.

Whether your vision is big or small, you’re in good company. Hundreds of thousands of small businesses, musicians, venues, restaurants, and non-profits are publishing and promoting their in-person and virtual events with The Events Calendar. Our plugins have also been scaled to work on large networks for Fortune 100 companies, universities, and government institutions.

✨ Features

Our feature-rich plugin comes with everything you need to create and manage your calendar.

✔️ Rapidly create events
✔️ Saved venues & organizers
✔️ Calendar month view with tooltips
✔️ Event List view
✔️ Day view
✔️ Block Editor support
✔️ Event search
✔️ Google maps
✔️ Widget: Upcoming events list
✔️ Events Taxonomies (Categories & Tags)
✔️ Google Calendar and iCal exporting
✔️ WP REST API endpoints
✔️ Completely ajaxified for super smooth browsing
✔️ Completely responsive from mobile to tablet to desktop
✔️ Tested on the major theme frameworks such as Avada, Divi, Enfold, Genesis, and many more.
✔️ Increase your SEO with JSON-LD Structured Data
✔️ Internationalized & translated
✔️ Multiple stylesheets to improve integration
✔️ Extensive template tags for customization
✔️ Hooks & filters galore
✔️ Caching support
✔️ Debug mode for developers
✔️ Library of extensions

📃 Documentation

All of our documentation can be found in our Knowledgebase.

Additional helpful links:

If you have any questions about this plugin, you can post a thread in the WordPress.org forum. Please search existing threads before starting a new one.

Add-Ons

Take your calendar to the next level by pairing it with our plugins for ticketing, crowdsourcing, email marketing, and more. Learn more about all our products on our website.

Our Free Plugins:

🎟️ Event Tickets
📐 Advanced Post Manager

Our Premium Plugins and Services:

Events Calendar PRO
↪️ Event Aggregator (service)
🎟️ Event Tickets Plus
📱 Event Tickets Wallet Plus
✉️ Promoter
👥 Community Events
🎟️ Community Tickets
✏️ Filter Bar
🗓️ Eventbrite Tickets
📡 Virtual Events

Help

If you aren’t familiar with The Events Calendar, check out our New User Primer. It will have you creating events in no time.

Ready to dig deeper? Check out these resources:

We check in on the The Events Calendar forum here on WordPress.org about once a week to help users with basic troubleshooting and identifying bugs. If you’re looking for premium, personalized support, consider upgrading to Events Calendar Pro.

Still have a question? Shoot us an email at support@theeventscalendar.com.

གཏུབ་རེིས།

  • Month View with hover
  • Mobile Views
  • Single event
  • List View
  • Event Editor
  • Events admin listing
  • General Settings
  • Display Settings
  • CSV Importer

སྒྲིག་འཇུག

Installing the plugin is easy. Just follow one of the following methods:

Install The Events Calendar from within WordPress

  1. Visit the plugins page within your dashboard and select ‘Add New’
  2. Search for “Events Calendar”
  3. Activate The Events Calendar from your Plugins page
  4. You’re done!

Install The Events Calendar Manually

  1. From the dashboard of your site, navigate to Plugins –> Add New.
  2. Select the Upload option and hit “Choose File.”
  3. When the popup appears select the the-events-calendar-x.x.zip file from your desktop. (The ‘x.x’ will change depending on the current version number).
  4. Follow the on-screen instructions and wait as the upload completes.
  5. When it’s finished, activate the plugin via the prompt. A message will show confirming activation was successful. A link to access the calendar directly on the frontend will be presented here as well.

That’s it! Just configure your settings as you see fit, and you’re on your way to creating events in style. Need help getting things started? Check out our new user primer for help with settings and features.

FAQ

Are there any troubleshooting steps you’d suggest I try that might resolve my issue before I post a new thread?

First, make sure that you’re running the latest version of The Events Calendar. If you’re running Events Calendar PRO or any other add-ons, make sure those are current / running the latest code as well.

The most common issues we see are either plugin or theme conflicts. You can test if a plugin or theme is conflicting by manually deactivating other plugins until just The Events Calendar is running on your site. If the issue persists from there, revert to the default Twenty Twenty theme. If the issue is resolved after deactivating a specific plugin or your theme, you’ll know that is the source of the conflict.

Note that we aren’t going to say “tough luck” if you identify a plugin/theme conflict. While we can’t guarantee 100% integration with any plugin or theme out there, we will do our best (and reach out the plugin/theme author as needed) to figure out a solution that benefits everyone.

I’m still stuck. Where do I go to file a bug or ask a question?

Users of the free The Events Calendar should post their questions in the plugin’s WordPress.org forum, which we visit about once a week. Please make sure to read our sticky post providing an overview of the support we provide free users BEFORE posting. If you find you’re not getting support in as timely a fashion as you wish, you might want to consider purchasing a license for Events Calendar Pro.

If you’re already an Events Calendar Pro user, you’re entitled access to our actively-monitored Premium Support on our website. We can provide a deeper level of support here and hit these forums on a daily basis during the work week. Generally, except in times of increased support loads, we reply to all tickets within 24-48 hours during the business week.

What’s the difference between The Events Calendar and Events Calendar Pro?

The Events Calendar is our cornerstone plugin, and it’s required in order to run any of our premium calendar add-ons, including Events Calendar Pro, Community Events, Filter Bar, and others.

In other words, Events Calendar Pro runs alongside The Events Calendar and enhances it with extra features, including recurring events, additional calendar views, calendar shortcodes, advanced widgets, custom event fields and more.

What add-ons are available for The Events Calendar, and where can I read more about them?

The following add-ons are available for The Events Calendar:

  • Events Calendar Pro, for adding premium calendar features like recurring events, advanced views, cool widgets, shortcodes, additional fields, and more!
  • Event Aggregator, a service that effortlessly fills your calendar with events from Meetup, Google Calendar, iCalendar, Eventbrite, CSV, and ICS.
  • Virtual Events, which optimizes your calendar for virtual events including Zoom integration, video and livestream embeds, SEO optimization for online events and more.
  • Event Tickets (free), which allows you to sell tickets and collect RSVPs to events. It can run alongside The Events Calendar or as a standalone plugin that adds ticket and RSVP functionality to WordPress posts and pages.
  • Event Tickets Plus, which allows you to sell tickets for your events using your favorite e-commerce platform.
  • Event Tickets Wallet Plus, for adding digital tickets like Apple Wallet passes and PDF tickets.
  • Promoter, automated email communication made just for The Events Calendar and Event Tickets. Stay in touch with your attendees every step of the way.
  • Community Events, for allowing frontend event submission from your readers.
  • Community Tickets, which allows event organizers to sell tickets to the events they submit via Community Events.
  • Filter Bar, for adding advanced frontend filtering capabilities to your events calendar.
  • Eventbrite Tickets, for selling tickets to your event directly through Eventbrite.

Can I import events to my calendar?

Yes! The Events Calendar has a built-in CSV import tool. If you want to step it up and automatically import events from Google Calendar, Meetup, Eventbrite and more, check out Event Aggregator.

How do I sell tickets to events on my calendar?

You’ll want to use our Event Tickets plugin for that. This free plugin works alongside The Events Calendar and lets you create RSVPs and tickets for events. Event Tickets integrates with PayPal so you can collect payments for tickets, while our premium solution, Event Tickets Plus fully integrates with WooCommerce or Easy Digital Downloads. If you want to include digital tickets like Apple Wallet passes and PDF tickets check out Event Tickets Wallet Plus.

Can I have more than one calendar on my site?

Unfortunately, no. However, you can use event categories or tags to create calendar views that only display certain events. For example, you could create a direct link to a calendar view that only shows events categorized as “Fitness,” like this example from our demo site.

With Events Calendar Pro, you can use shortcodes to embed your calendar on other WordPress pages and posts, then filter that calendar by category.

Can I allow people to submit events to my calendar?

This is available with the Community Events add-on to facilitate submissions. Install Community Events alongside The Events Calendar and a page will be added to your WordPress site with a form that visitors can use to submit events. As the calendar owner, you have full control over whether event submissions are published immediately or require moderation first.

If you want to let users sell tickets for the events they submit, check out Community Tickets. It runs with The Events Calendar, Community Events, and Event Tickets and empowers visitors to create and sell tickets, splitting the profits with you.

What’s the difference between The Events Calendar and Events Calendar Pro

The Events Calendar is our cornerstone plugin, and it’s required in order to run any of our premium calendar add-ons, including Events Calendar Pro, Community Events, Filter Bar, and others.

In other words, Events Calendar Pro runs alongside The Events Calendar and enhances it with extra features, including recurring events and event Series, additional calendar views, calendar shortcodes, advanced widgets, custom event fields, a duplicate event tool, and more.

I have a feature idea. What’s the best way to tell you about it?

We’ve got an ideas page where we’re actively watching for feature ideas from the community. Vote up existing feature requests or add your own, and help us shape our roadmap.

I’ve still got questions. Where can I find answers?

Check out our extensive knowledgebase for articles on using, tweaking, and troubleshooting our plugins.

གདེང་འཇོག

2024 ལོའི་ཟླ 2 ཚེས 22 ཉིན།
my wife and I are artist. We own an Art studio/gallery and when we decided to add Paint-n-Sip Events and art classes to our business we naturally looked for a way to add an event calendar to our website. I understand that it would be impossible for a plug-in to meet everyone's needs, but of all the Event Calendar plug-ins I tried, this one came the closest. But beyond that, when I contacted them with a question about a feature, they were very prompt in replying. So for great support, ease of use and how it functions on my website, I gladly give it 5 stars.
2024 ལོའི་ཟླ 2 ཚེས 21 ཉིན།
I've been using TEC for years. Great workhorse, always reliable, stable and useful. Fantastic support, even if you're just using the free version. Thanks for a great product!
2024 ལོའི་ཟླ 2 ཚེས 20 ཉིན།
Had an issue trying to get the calendar to display in a particular way ... Guga responded quickly complete with css code to paste into Wordpress. This great software is only outshone by its customer service folks like Guga. Thank you.
2024 ལོའི་ཟླ 2 ཚེས 20 ཉིན།
Paul with support was awesome! He responded within a couple hours with a solution for a conflict we were having with Event Tickets and Betheme that worked perfectly the first time.
གདེང་འཇོག 2,205 ཡོངས་སུ་ཀློག

བྱས་རྗེས་འཇོག་མཁན། & གསར་འབྱེད་པ།

“The Events Calendar” is open source software. The following people have contributed to this plugin.

བྱས་རྗེས་འཇོག་མཁན།

“The Events Calendar” has been translated into 28 locales. Thank you to the translators for their contributions.

ཁྱེད་ཀྱི་སྐད་ཡིག་ནང་ལ་ “The Events Calendar” ཡིག་སྒྱུར་བྱོས།

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

དག་བཅོས་ཉིན་ཐོ།

[6.3.3.1] 2024-02-22

  • Fix – On a multisite using WordPress 6.4.3 there was an issue with the subsite options not being properly created during initialization. [TEC-5043]

[6.3.3] 2024-02-19

  • Version – The Events Calendar 6.3.1 is only compatible with Event Tickets 5.8.1 and higher.
  • Tweak – Refactored some of the underlying structure for Block Template architecture. [ECP-1620]
  • Tweak – Added filters: tec_events_get_full_site_block_template_services
  • Tweak – Changed views: blocks/event-links, single-event, v2/components/data
  • Language – 4 new strings added, 4 updated, 0 fuzzied, and 0 obsoleted

[6.3.2] 2024-02-06

  • Tweak – Share statistical information to Event Tickets plugin when active. [ET-1925]
  • Fix – Improve the usage of the shortcodes around Event Details.
  • Language – 0 new strings added, 0 updated, 0 fuzzied, and 0 obsoleted

[6.3.1] 2024-01-24

  • Fix – Fix PHP 8.2 deprecation errors PHP Deprecated: Creation of dynamic property Tribe__Events__Aggregator__Record__gCal::$image_uploader is deprecated. [ECP-1603]
  • Fix – Make sure that the full country name is used when importing events from Meetup. [EA-469]
  • Fix – Our Week view “Next” pagination button would fail to show in some scenarios. This was due to improper tracking of which is the next future occurrence date. [ECP-1535]
  • Fix – Resolved an issue where adding multiple venues in block editor would not persist the second venue after the page was reloaded. [ECP-1637]
  • Tweak – Added actions: tec_events_custom_tables_v1_migration_after_dry_run
  • Tweak – Adding some more testing and some clean up around handling and reporting query errors. [TECENG-46]
  • Language – 0 new strings added, 115 updated, 0 fuzzied, and 0 obsoleted

[6.3.0] 2024-01-22

  • Version – The Events Calendar 6.3.0 is only compatible with Event Tickets 5.8.0 and higher.
  • Feature – Include Series Passes supporting code to enable the creation of Series Passes.
  • Tweak – Added the tec_events_custom_tables_v1_migration_after_dry_run filter. [ET-1715]
  • Language – 0 new strings added, 92 updated, 0 fuzzied, and 0 obsoleted

[6.2.9] 2023-12-14

  • Fix – Resolves an issue where the tribe-events-calendar-month__day--past and tribe-events-calendar-month__day--current classes were not consistently applied after navigating through different months in the Month View. [TEC-4898]
  • Tweak – Define image sizes on the List view featured image to avoid Content Layout Shifting. [TEC-4919]
  • Fix – When on category page when there is a locale switched to a language with a translation for the page URL param, the paginated page would redirect to a 404. [TEC-4979]
  • Tweak – Updated the tribe_get_venues function to work with recurring events that have provisional IDs. [ECP-1597]
  • Tweak – Added filters: tec_events_custom_tables_v1_normalize_occurrence_id
  • Tweak – Changed views: v2/list/event/featured-image
  • Language – 0 new strings added, 2 updated, 0 fuzzied, and 0 obsoleted

[6.2.8.2] 2023-12-04

  • Fix – Ensure correct access rights to JSON-LD data depending on the user role. [TEC-4995]
  • Language – 0 new strings added, 130 updated, 0 fuzzied, and 5 obsoleted

[6.2.8.1] 2023-11-20

  • Security – Ensure all password protected posts have their settings respected. [TCMN-167]

[6.2.8] 2023-11-16

  • Version – The Events Calendar 6.2.8 is only compatible with Event Tickets 5.7.0 and higher
  • Tweak – Include Event data into for Event Tickets Wallet Plus for both PDF and Apple Wallet passes.
  • Language – 0 new strings added, 135 updated, 0 fuzzied, and 11 obsoleted

[6.2.7] 2023-11-14

  • Fix – On the Past Events View, the nonce was incorrectly being generated twice, and one of them would be cached in our HTML transient cache. This was causing a 401 nonce errors to occur when the cached nonce expired. The nonce generation was moved outside the HTML generation that is being cached. [TEC-4936]
  • Fix – WordPress 6.3 introduce some changes in filters that regressed a prior fix for authentication and our new nonce structure used in view pagination. One symptom of the issue was losing the authenticated user and failing to display user specific capabilities on event views. [ECP-1601]
  • Fix – Resolves issue where a deleted venue still attached to an event would cause an PHP Warning: Undefined variable $data in /code/wp-content/plugins/the-events-calendar/src/Tribe/REST/V1/Post_Repository.php on line 327 error. [TEC-4954]
  • Fix – Resolves an issue with certain versions of WordPress already having the legacy widget block registered causing us to trigger the console error Block "core/legacy-widget" is already registered. would occur. Now we check if registered first. [TEC-4764]
  • Fix – Resolved several Deprecated: Creation of dynamic property warnings on: \Tribe__Events__Linked_Posts__Chooser_Meta_Box::$singular_name_lowercase and \TEC\Events\Custom_Tables\V1\Models\Builder::$query [BTRIA-2088]
  • Tweak – Adjust the content in the admin welcome page to include a link to the TEC Facebook community group. [TEC-4953]
  • Tweak – Added filters: tec_events_get_full_site_block_template_services, tec_events_views_v2_get_rest_nonce_html
  • Tweak – Changed views: blocks/archive-events, blocks/single-event
  • Language – 11 new strings added, 119 updated, 0 fuzzied, and 5 obsoleted.

[6.2.6.1] 2023-11-09

  • Version – The Events Calendar 6.2.6.1 is only compatible with Event Tickets 5.6.8.1 and higher
  • Fix – Update a common library to prevent possible fatals. [TEC-4978]
  • Language – 0 new strings added, 2 updated, 0 fuzzied, and 0 obsoleted

[6.2.6] 2023-11-08

  • Fix – SEO: Ensure that the noindex meta tag properly observes whether events are present on the page or not. [TEC-4976]
  • Fix – SEO: Add noindex, nofollow for grid-based views like Month and Week View when they are not set as the home page. [TEC-4976]
  • Tweak – Add an X-Robots-Tag to the response headers for ical download links to help prevent search engine crawling. [TEC-4976]
  • Tweak – Added filter: tec_events_ical_header_noindex to allow preventing the X-Robots-Tag addition. [TEC-4976]
  • Tweak – Added filter tec_events_seo_robots_meta_include and tec_events_seo_robots_meta_include_{$view} to short-circuit the robots meta tag addition. [TEC-4976]
  • Tweak – Added filter tec_events_seo_robots_meta_content to alter the content attribute of the robots meta tag addition. [TEC-4976]
  • Tweak – Added filter tec_events_seo_robots_meta_allowable_post_types to allow for the filtering of single post types that can have robots meta tags added.
  • Tweak – Deprecated filters tec_events_add_no_index_meta_tag, tribe_events_add_no_index_meta, and tec_events_{$view}_add_no_index_meta in favor of the above new filters.

[6.2.5] 2023-11-01

  • Tweak – Updated hook for showing Event name in the event tickets order report pages. [ET-1810]

[6.2.4] 2023-10-19

  • Fix – AM/PM time formats g:i A and g:i a are now respected for the French locale. [TEC-4807]

[6.2.3.2] 2023-10-12

  • Fix – Prevent noindex code from adding tags to single event pages. [TEC-4949]
  • Fix – Correct a problem that can cause a fatal when plugins are deactivated in a certain order. [TEC-4951]

[6.2.3.1] 2023-10-09

  • Fix – Prevent a fatal caused by get_noindex_events on Events Calendar PRO views if PRO has not been updated. [TEC-4946]
  • Language – 0 new strings added, 2 updated, 0 fuzzied, and 0 obsoleted

[6.2.3] 2023-10-03

  • Fix – Ensure the UI can handle an unlimited number of recurrence rules when users create recurring events using the block editor. [ECP-1572]
  • Fix – Resolved “Uncaught ReferenceError: lodash is not defined” error by adding lodash as a dependency for the Block Editor Assets. [ECP-1575]
  • Fix – Resolves an issue around our new nonce structure used in view pagination, losing the authenticated user and failing to display user specific capabilities. [ECP-1581]
  • Tweak – Updated focus state for relevant elements to have default outline ensuring improved accessibility and consistent browser behavior. [TEC-4888]
  • Tweak – Added filters: tec_events_add_no_index_meta_tag, tec_events_noindex, tec_events_{$view}_add_no_index_meta, tec_events_no_index_meta
  • Language – 0 new strings added, 183 updated, 0 fuzzied, and 0 obsoleted

[6.2.2.1] 2023-09-28

  • Version – The Events Calendar 6.2.2.1 is only compatible with Event Tickets 5.6.5.1 and higher
  • Fix – Fix – Correct issue where Telemetry would register active plugins multiple times. [TEC-4920]

[6.2.2] 2023-09-13

  • Version – The Events Calendar 6.2.2 is only compatible with Event Tickets 5.6.5 and higher
  • Fix – When using the Event Tickets email feature the Organizer email and website will no longer be switched. [ET-1843]
  • Fix – When subscribing to an event, the organizer name will not encode as many characters, especially spaces. [ET-1778]
  • Language – 0 new strings added, 9 updated, 0 fuzzied, and 0 obsoleted

[6.2.1] 2023-09-05

  • Fix – WP Rewrite was being incorrectly initialized in some scenarios due to container DI, and causing some 404s. This was affecting classes that extend the Tribe__Rewrite. [TEC-4844]
  • Fix – Fixed a bug where 0 and 1 were displayed on the general and display tabs for Network admins on multisite installations. [TEC-4774]
  • Fix – In some cases when multiple Widgets were used on a page, the view results would return the wrong cache, displaying incorrect results. This fixes the inspection of the different view filters being used to determine whether it is cached or not. [ECP-1561]
  • Fix – Correct some accessibility issues in the subscribe dropdowns. Props to @alh0319 for calling these out! [TEC-4185]
  • Tweak – Enhanced venue and organizer labels by updating aria labels with additional placeholders and revised translator comments, improving internationalization and accessibility. [TEC-4874]
  • Tweak – Changed views: …