How to Import Events

Event Espresso provides an easy way to import basic events via a CSV (spreadsheet) file.

Important

This will not allow you to import Recurring events.

Where to import

The Import Events button is located in the Event Overview page, below the event list itself.

Clicking this button will take you to the import screen. Here you can download a copy of the sample spreadsheet you can use to create your own and import the actual spreadsheet.

import_an_event_button

import_an_event_screen

Creating a CSV

If you examine the sample spreadsheet you will see that the first row contains all the information about what you can import:

0This dictates whether the plugin should ignore the entire row or not, 0 = ignore, 1 = import. In general, the first row containing the field titles should be 0 and the rest should be 1
event_nameThe event name
event_descThe event description, basic html is allowed
addressFirst line of the address (not venue)
cityCity of the address (not venue)
stateState/province of the address (not venue)
countryCountry of the address (not venue)
zipZip/postal code of the address (not venue)
phonePhone number of the address (not venue)
display_descDisplay the event description? Use Y or N
event_identifierAdd a unique event identifier
start_dateAdd the event start date (format = Y-m-d for example 2013-07-25)
end_dateAdd the event end date (format = Y-m-d for example 2013-07-25)
start_timeAdd the event start time (format = 10:00:00 AM)
end_timeAdd the event end time (format = 10:00:00 AM)
reg_limitAdd the maximum number of attendees for the event, enter 999999 for unlimited
event_costThe event price, do not use currency symbols!
allow_multipleAllow group registrations? Use Y or N
additional_limitGroup size, use numbers only.
send_mailSend the registration confirmation email? Use Y or N
is_activeIs this an active event? Use Y or N
conf_mailAdd the content of your confirmation email here, basic HTML and email tags are allowed.
registration_startAdd the registration start date (format = Y-m-d for example 2013-07-25)
registration_endAdd the registration end date (format = Y-m-d for example 2013-07-25)

 

Blank Fields

Whilst it is possible to leave some of these fields blank, it is advisable to fill out the following as an absolute minimum

0

Event_name

Event_identifier

Start_date

End_date

Is_active

Registration_start

Registration_end

 

Importing

Save the spreadsheet as a CSV file named events.csv. Any other name or format will fail to import!

In the Import Events page, click the Choose file button, and select the newly saved events.csv file. Then click the blue Upload File & Add Event(s) button.

You will see a message on screen confirming success or failure.

 

Important Information

Please note that the use of single quotation marks ( ‘ ) and returns (pressing enter to make a new line) should be avoided in the import file as these can cause errors.


Need more help?

  • Browse or search for more information on this topic in our support forums. Customers with an active support license can open a support topic and get help from Event Espresso staff.
  • Have an emergency? Purchase a support token and get expedited one-on-one help!
  • Go back to documentation for Event Espresso
Event Espresso - Staging Server