The Events Calendar Shortcode & Block

Here’s the full list of shortcode and block options you can use to customize how your events display:

• Basic shortcode: [ecs-list-events]
• cat – Show events from an event category [ecs-list-events cat='festival'] or specify multiple categories [ecs-list-events cat='festival, workshops']
• limit – Total number of events to show. Default is 5. [ecs-list-events limit='3']
• order – Order of the events to be shown. Value can be ‘ASC’ or ‘DESC’. Default is ‘ASC’. Order is based on event date. [ecs-list-events order='DESC']
• date – To show or hide date. Value can be ‘true’ or ‘false’. Default is true. [ecs-list-events eventdetails='false']
• venue – To show or hide the venue. Value can be ‘true’ or ‘false’. Default is false. [ecs-list-events venue='true']
• excerpt – To show or hide the excerpt and set excerpt length. Default is false. [ecs-list-events excerpt='true'] //displays excerpt with length 100
  excerpt=’300′ //displays excerpt with length 300
• thumb – To show or hide thumbnail image. Default is false. [ecs-list-events thumb='true'] //displays post thumbnail in default thumbnail dimension from media settings.
• thumbsize – Specify the size of the thumbnail. [ecs-list-events thumb='true' thumbsize='large']
• thumbwidth / thumbheight – Customize the thumbnail size in pixels [ecs-list-events thumb='true' thumbwidth='150' thumbheight='150']
• message – Message to show when there are no events. Defaults to ‘There are no upcoming events at this time.’
• viewall – Determines whether to show ‘View all events’ or not. Values can be ‘true’ or ‘false’. Default to ‘true’ [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false']
• contentorder – Manage the order of content with commas. Default to title, thumbnail, excerpt, date, venue. [ecs-list-events cat='festival' limit='3' order='DESC' viewall='false' contentorder='title, thumbnail, excerpt, date, venue']
• month – Show only specific month (in YYYY-MM format). Type 'current' for displaying current month only or 'next' for next month. [ecs-list-events cat='festival' month='2024-06']
• past – Show Outdated Events. [ecs-list-events cat='festival' past='yes']
• key – Hide events when the start date has passed [ecs-list-events cat='festival' key='start date']
• orderby – Change the ordering to the end date [ecs-list-events orderby="enddate"]

With The Events Calendar Shortcode & Block Pro you also get the following options:

• design – Shows improved design by default. Set to ‘standard’ for the regular one, ‘compact’ for a more compact listing, ‘calendar’ for a monthly calendar view, ‘columns’ to show a horizontal/columns/photo view, or ‘grouped’ to group events by day
• filter bar – Allow the user to filter the events shown (ie. by category, state/province, country, venue, etc)
• pagination – Allow the user to view additional pages of events
• days – Specify how many days in the future, for example [ecs-list-events days="1"] for one day or [ecs-list-events days="7"] for one week
• tag – Filter by one or more tags. Use commas when you want to filter by multiple tags.
• id – Show a single event, useful for displaying details of the event on a blog post or page
• location (city, state/province, country) – Display events by location. Use commas when you want to include events from multiple (ie. country=’United States, Canada’)
• description – Use the full description instead of the excerpt of an event in the listing
• raw_description – Avoid filtering any HTML (spacing, links, bullet points, etc) in the description
• raw_excerpt – Avoid filtering any HTML (spacing, links, etc) in the excerpt
• featured only – Show only events marked as “featured”
• date – Show only events for a specific day [ecs-list-events date='2024-04-16']
• year – Show only events for a specific year [ecs-list-events year='2024']
• date range – Show only events between certain days [ecs-list-events fromdate='2024-05-31' todate='2024-06-15']
• timeonly – To show just the start time of the event. [ecs-list-events timeonly='true']
• offset – Skip a certain number of events from the beginning, useful for using multiple shortcodes on the same page (with ads in between) or splitting into columns
• custom design – Create one or more of your own using shortcode variables or templates for use with the shortcode
• hiderecurring – To only show the first instance of a recurring event, set to ‘true’

Get The Events Calendar Shortcode & Block Pro