Customizing Template Files

The Events Calendar comes with a number of template files that determine how the plugin looks and behaves. We call these views. You can customize these files by placing copies of them in your theme.

It’s important that you don’t edit the view files directly in the plugin. Instead, we recommend overriding the files in your theme, which is what we are going to cover in this guide. This ensures that any changes you make to the files will not be lost when new versions of the plugins are released. In fact, we strongly recommend keeping your custom calendar view templates in a child theme, especially if you use a third-party theme that releases new versions. This plugin can be helpful for creating child themes. The Events Calendar will ensure that your modified files, in the correct folder, will override the plugin files.

OK, now that we’ve established some housekeeping rules, let’s dig into the process of customizing template files by overriding them in your theme.

Locating template files

Every plugin is located on your server where WordPress is installed in the /wp-content/plugins folder. Here’s where you can find the template files for each plugin.

Plugin	Template Files
The Events Calendar	/the-events-calendar/src/views/v2/
Events Calendar Pro	/events-calendar-pro/src/views/v2/

Exceptions

There are a few exceptions to this. The single event pages still use the files from the legacy design, and there is both a classic editor and a block editor version. You can find those files here:

Plugin	Template Files	Override Location
Classic Editor	Single event, single organizer, single venue pages	This can also be found at the top of each original PHP file.
The Events Calendar	/the-events-calendar/src/views/single-event.php	[your-theme]/tribe-events/single-event.php
The Events Calendar	/the-events-calendar/src/views/modules/	[your-theme]/tribe-events/modules
Events Calendar Pro	/events-calendar-pro/src/views/pro/modules/	[your-theme]/tribe-events/pro/modules/
Block Editor	Single event page
The Events Calendar	/the-events-calendar/src/views/single-event-blocks.php	[your-theme]/tribe/events/single-event-blocks.php
The Events Calendar	/the-events-calendar/src/views/single-event/	[your-theme]/tribe/events/single-event/
Events Calendar Pro	/events-calendar-pro/src/views/blocks/	[your-theme]/tribe/events-pro/blocks/

To override these files the copy should be placed in /tribe-events and /tribe-events/pro respectively. For further details please check out the guide to customizing template files for Views 1.

Block Editor

When creating template overrides for the Block Editor, the file path will depend on whether you are using the blocks that are specific to the The Events Calendar plugin vs the Events Calendar Pro plugin.

When using The Events Calendar blocks, the copy should be placed here: [your-theme]/tribe/events/blocks/

Here are the The Events Calendar blocks:

• Classic Event Details Block
• Event Category Block
• Event Datetime Block
• Event Links Block
• Event Organizer Block
• Event Price Block
• Event Tags Block
• Event Venue Block
• Event Website Block
• Featured Image Block

You can find all of The Events Calendar template files here.

When using Events Calendar Pro blocks, the copy should be placed here: [your-theme]/tribe/events-pro/blocks/

Here are the Events Calendar Pro blocks:

• Additional Fields Block
• Recurrence Block
• Related Events Block

You can find all of the Events Calendar Pro template files here.

First, add a new folder in your theme

Once you’ve located the template file you want to customize, make a copy of it and save it somewhere for a moment, like your computer desktop.

Next, let’s head over to your theme folder and create a new folder.  Not sure where your theme folder is located? It’s where WordPress is installed in the /wp-content/themes folder. So if you are using the official Twenty Twenty theme, it would be at /wp-content/themes/twentytwenty. Once you find it, create a new folder called tribe.

So far, you should have a new folder in your theme located at: /wp-content/themes/your-theme/tribe/

Now, which plugin or add-on does your copied template file belong to? You’ll need to make another folder that correlates with the plugin you are customizing. That includes the following:

Plugin	Folder
The Events Calendar (legacy views)	/tribe/events/
The Events Calendar (new views)	/tribe/events/v2
Events Calendar Pro	/tribe/events-pro/v2

With the new views, your folder structure should look like this:

Customize the template

Now that you’ve located the template you want to override, made a copy of it, created a new tribe/ folder in your theme, and put the copied template file in its corresponding plugin folder, you can start customizing!

If you’re feeling stuck at any point in the process, we’ve put together an example of a customization that you can check out that walks through this process one step at a time.