The shortcode is only available on the Pro version.
The best way to explore the shortcode is to use the dynamic shortcoder builder here. One of the great things about the shortcode builder – is you can use your won Eventbrite data so can test and see what your events are doing. The rest of this page is the detailed documentation of the shortcode.
the basic shortcode is
The Pro plugin comes with 7 default layouts.1 – ( the default ) which is full page width and CSS that works well with Genesis and TwentySeventeen among others
divi – built to use the divi theme classes to pick up button design
grid – a responsive grid format based on the default themes
divigrid – a responsive grid suitable for divi
cal – uses a calendar layout – ( language translation will be attempted automatically see note here about languages )
cal_list a monthly calendar view in list format
widget – uses the same layout as the widget
You can define which layout is used like this, different layouts may warrant different total number of events ( limit )
[wfea layout='grid' limit='6']
[wfea layout='divigrid' limit='9']
[wfea layout='cal' limit='9999']
[wfea layout='cal_list' limit='9999'] [wfea layout='widget']
Which can be used on pages or post as appropriate.
There are many additional shortcode options giving you flexibility to chose what you need. You can see many examples of these in action on the demo website.
api_key [default ”] (text) Overide the API token in settings, enabling multiple accounts on one site
booknow [default true] (true or false) if true displays a call to action button
booknow_text [default Register »] (text) text for the call to action button
cal_list_days [default 0](integer) sets the numbers of days on the calendar list view. By default the view is monthly, but set to 90 days to give the next 90 days, 365 for the next 365 etc.
cal_list_header_left[default title]( allowed buttons) Use to customise the calendar list header buttons, set all three (left, center, right) to ” (empty) to have no header. Allowed buttons = title prev next prevYear nextYear today. Buttons can be combined with commas , e.g. prev,next
cal_list_header_center[default ”]( allowed buttons) see above – calendar list header center.
cal_list_headerright[default prev,next]( allowed buttons) see above – calendar list header right.
category_id [default nothing] (integer) limit to a specific category id – finding the category_id isn’t simple as you need the internal number The list at the time of writing is here. You can use [wfea debug='true'] to see the underlying data or – this guide( Finding IDs) is one way to get that information.
content [default false] (true or false) setting content=’true’ will display the HTML markup from Eventbrite, and the excerpt, length, readmore and readmore_text parameters will be ignored
cssID: [default nothing] (text) sets the CSS ID for the whole section, used by developers
css_class: [default nothing] (text) sets an additional CSS class for the whole section, used by developers
date : [default true] (true or false) if true displays the date / time of the event
display_private : [default true] (true or false) if true displays private events.
debug: [default false] (true or false) displays a dump of all your selected events, useful if you are having trouble finding out organizer_id or venue_id, or extending one of the default templates.
excerpt [default true] (true or false) if true an excerpt of the Summary on Eventbrite will be displayed – please note Eventbrite UI provides the Summary description to the API, this is limited by Eventbrite to 140 characters. If you want the full description set long_description to true.
filter_location [default nothing] (text / encoded regex ) filter_allows allows you to filter on the location name in the same manner as filtering the title below.
filter_title [default nothing] (text / encoded regex ) filter_title allows you to select just events where the title matches this filter. The filter can be a simple text string e.g. Singing which will display all events with Singing anywhere in the title. Note this is case sensitive. You can also use a regex without the delimiters ( if you want to use delimiters use / )e.g. /singing/i for case insensitive or ^ Singing for all titles staring with Singing or ^(Singing|Shouting) for example using regex or structure etc or any regex features ( you can check your regex at sites like https://regex101.com/ ). Except as regex can include [ ] a.g ^[Ss]inging the reg ex has to be url-encoded – you can use the input field below to generate the encoded field e.g. ^[Ss]inging becomes %5E%5BSs%5Dinging
Regular expressions (regex) are very powerful, for instance you can use them to filter out strings too, e.g. ^((?!badword).)*$ see https://www.regextester.com/95714 for a useful testing tool.
first_of_series [default false] (true or false) If set to true, only the first displayed event of a linked series of events will be displayed.
layout [default 1] (text) defines the layout template, this is an advanced developer feature to allow custom templates.
length [default 50] ( +ve integer ) the number of words of description to display ( length will be ignored if you set content to true to get the full html )
limit [default 5] ( +ve integer ) sets the number of events to display, the soonest first, good idea on calendar layouts to set this to a large number like 9999
location [default nothing] ( selection of values ) If a value is set that will be used in the disaply for location. Possible values are address_1, address_2, city, postal_code, country, localized_display_address, localized _display_area. Generally you should pick one of the localized options.
location_title [default nothing] ( text ) If you are displaying a location, then you may want a title, use this text field for that title.
long_description: [default false] Use the long description rather than summary ( only use this for the new interface where you get both summary and full description options ), optionally you may want to use this when content=’true’ to get the HTML markup.
newtab [default false] (true or false) if true any clicked link will be open in a new tab
order_by: [default asc] (text asc | desc) asc = ascending date, desc = descending – useful if showing events in the past see demo here
organizer_id: [default nothing] (integer) limit to a specific organiser id if you have several – finding the organizer_id isn’t simple as you need the internal number – this guide( Finding Organizer Id) is one way to get that information.
popup [default false] (true or false) if popup=’true’ all click actions ( except readmore ) will open a ticket purchase popup / modal on your site. Additionally the tickets and newtab parameters are ignored ( Please note: it is not possible to embed the full checkout process into a popup due to restrictions imposed by Eventbrite on framing their website )
readmore [default true] (true or false) if true will display a read more link after excerpt
readmore_text [default Read More »] (text) text for the read more link
search: [default nothing] keyword(s) to search across titles, location names and description
subcategory_id [default nothing] (integer) limit to a specific subcategory id (often not used) – finding the venue_id isn’t simple as you need the internal number you can use [wfea debug='true'] to see the underlying data or – this guide( Finding IDs) is one way to get that information.
start_date_range_start & start_date_range_end [default none] (date strings) always use a start and end pair or it will be ignored. The date range can (and should) be relative e.g. start_date_range_start=’first day of -3 months’ start_date_range_end=’+1 year’ would show the prior 3 months and the next year ( would require also status=’ended,started,live’ )
status: [default live] (text live,started,ended,cancelled,draft,all ) comma separated list of event status, e.g. if you want prior events used ended,started
tickets [default false] (true or false) default is false, if true the call to action button link goes straight to the ticket pop up on the Eventbrite page
thumb [default true] (true or false) if true displays the thumbnail image from Eventbrite, please note Eventbrite by default provide an image optimised and limited in size ( approx 400px to 450px depending on various factors ), bear this in mind when designing wide layouts. If you need higher resolution images set thumb_original to true.
thumb_align [default eaw-aligncenter] (text) Widget Template Only – class for the thumbnail image alignment, preset values are eaw-alignleft, eaw-aligncenter, eaw-alignright.
thumb_default [default https://placehold.it/600×400/f0f0f0/ccc] (text url) link to a default image that will be used if no image provided by Eventbrite. You may need to adjust this to suit your template.
thumb_original [default false] (true or false) Use the origional uploaded image instead of teh optimised image. Use this for large ‘hero’ type layouts.
thumb_width [default 300 ] (integer) Widget Template Only – sets the thumbnail width as in the way the widget can
venue_id : [default nothing] (integer) limit to a specific venue id – finding the venue_id isn’t simple. The easiest way is to use your API key in the dynamic shortcoder builder and start typing any thing in the Venue ID box.
widgetwrap [default true ] (true or false) Widget Template Only – add an additional widget wrapper around the output to use the default widget style – when the shortcode is used in an article. Set to false if the shortcode is used in a text widget or you are custom styling.