Custom Files Add-on Documentation

The Custom Files add-on provides PHP files that allow you to override certain aspects of the Event Espresso. For example, you can override some of the core functions. There are also sample templates that can be used along with example shortcodes to provide table layouts. You can also add your own functions that you would like included when the plugin runs.

View quick links for this add-on –> 

Need to Buy a Support License for the Custom Files Add-on?


This add-on requires Event Espresso 3.1.33 or newer. It cannot be used with old versions of Event Espresso 3.

This add-on is not a plugin for WordPress and cannot be installed through your WP dashboard (WP-admin).

Step 1: Download the latest version of the Custom Files add-on from your Event Espresso account. Then unzip the folder and make a note of its location on your computer.

Step 2: Login to your WordPress site with your preferred SFTP or FTP client. FileZilla and Cyberduck are free options.

Step 3: Browse to this location using your SFTP or FTP client:

Step 4: Locate the following files on your computer in the folder that you unzipped in step 1:




Step 5: Upload the files above to the following location:

Step 6: Browse to this location using your SFTP or FTP client:

Step 7: Upload any templates from the add-on folder to this location:

Note: the custom_*.php files are uploaded to /wp-content/uploads/espresso
Template files which are different are uploaded to /wp-content/uploads/espresso/templates


This add-on is helpful for organizing customizations to Event Espresso 3. You should never modify the core plugin in /wp-content/plugins/event-espresso as your edits will be lost on a software update.

The Custom Files add-on is an ideal spot to add these changes.

custom_includes.php – Should be used to include your custom templates or any other files you need loaded into the plugin
custom_functions.php – Place all of your custom functions in this file
custom_shortcodes.php – Place all of your custom shortcodes in this file


The plugin will not install. Can you help?
This plugin is not a WordPress plugin so it cannot be installed through the WP dashboard. Please take a look at the installation section in this article for how to install this add-on.


Our support team cannot write custom coding for you. Below are some examples on customizing this add-on.

  • Have you found a custom code snippet in our support forums? The custom_functions.php file is a good spot to add that code snippet!

Need to Buy a Support License for the Custom Files Add-on?

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us