The Events Calendar Shortcode & Block icon
Events & Booking

The Events Calendar Shortcode & Block hooks reference

  • By Event Calendar Newsletter
  • v4.0.0
  • Updated

The Events Calendar Shortcode & Block 4.0.0 has 6 actions and 67 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.

How to use these hooks

Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.

functions.phpyour child theme
// Run your own code when The Events Calendar Shortcode & Block fires an action
add_action( 'ecs_admin_page_options_after', function() {
	// Your code runs here.
}, 10, 1 );

// Change a value The Events Calendar Shortcode & Block is about to use
add_filter( 'ecs_admin_page_capability', function( $value ) {
	// Change $value here.
	return $value;
}, 10, 1 );

Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.

All hooks

  • the-events-calendar-shortcode.php line 83 · used in 2 places
    apply_filters( 'ecs_admin_page_capability', 'edit_published_posts' );
  • includes/bricks/bricks-element.php line 28 · used in 2 places
    apply_filters( 'ecs_bricks_designs', [ 'free' => esc_html__( 'Standard', 'the-events-calendar-shortcode' ), ] );
  • includes/elementor/elementor-widget.php line 119 · used in 2 places
    apply_filters( 'ecs_elementor_thumbnail_width_and_height_conditions', [ 'thumbnail' => 'yes', 'thumbnail_dimensions_choice' => 'width_and_height', ] );
  • the-events-calendar-shortcode.php line 427 · used in 2 places
    apply_filters( 'ecs_event_thumbnail', get_the_post_thumbnail( get_the_ID(), apply_filters( 'ecs_event_thumbnail_size', [ $thumbWidth, $thumbHeight ], $atts, $post ) ), $atts, $post );
  • the-events-calendar-shortcode.php line 427 · used in 2 places
    apply_filters( 'ecs_event_thumbnail_size', [ $thumbWidth, $thumbHeight ], $atts, $post );
  • templates/admin-page.php line 2 · used in 2 places
    apply_filters( 'ecs_show_upgrades', true );
  • templates/admin-page.php line 10
    do_action( 'ecs_admin_page_options_after' );
  • templates/admin-page.php line 9
    do_action( 'ecs_admin_page_options_after_cat' );
  • templates/admin-page.php line 118
    do_action( 'ecs_admin_page_options_before' );
  • templates/admin-page.php line 27
    do_action( 'ecs_admin_page_options_top' );
  • templates/admin-page.php line 249
    do_action( 'ecs_admin_page_styling_before' );
  • the-events-calendar-shortcode.php line 388
    apply_filters( 'ecs_always_show', false, $atts );
  • the-events-calendar-shortcode.php line 369
    apply_filters( 'ecs_atts_pre_query', $atts, $meta_date_date, $meta_date_compare );
  • the-events-calendar-shortcode.php line 389
    apply_filters( 'ecs_beginning_output', $output, $posts, $atts );
  • block/init.php line 42
    apply_filters( 'ecs_block_attributes', [ 'design' => [ 'type' => 'string', 'default' => 'standard', ], 'limit' => [ 'type' => 'number', ], 'settings' => [ 'type' => 'string', 'default' => json_encode( [ 'design', 'limit', 'order', 'thumb', 'venue', 'excerpt', 'contentorder' ] ), ], 'cat' => [ 'type' => 'string' ], 'month' => [ 'type' => 'string' ], 'thumb' => [ 'type' => 'string', ], 'thumbsize' => [ 'type' => 'string', ], 'thumbwid... );
  • block/init.php line 155
    apply_filters( 'ecs_block_render_attribute', '', $key, $value );
  • includes/bricks/bricks-element.php line 256
    apply_filters( 'ecs_bricks_atts', $atts, $this->settings );
  • includes/bricks/bricks-element.php line 177
    apply_filters( 'ecs_bricks_categories', $categories );
  • includes/bricks/bricks-element.php line 77
    apply_filters( 'ecs_bricks_thumbnail_condition', null );
  • the-events-calendar-shortcode.php line 266
    apply_filters( 'ecs_default_contentorder', 'title, thumbnail, excerpt, date, venue', $atts );
  • includes/elementor/elementor-widget.php line 45
    apply_filters( 'ecs_elementor_design_default', '' );
  • includes/elementor/elementor-widget.php line 42
    apply_filters( 'ecs_elementor_designs', [ '' => __( 'Standard', 'the-events-calendar-shortcode' ), ] );
  • includes/elementor/elementor-widget.php line 67
    apply_filters( 'ecs_elementor_limit_condition', [] );
  • includes/elementor/elementor-widget.php line 91
    apply_filters( 'ecs_elementor_thumbnail_condition', [] );
  • includes/elementor/elementor-widget.php line 145
    apply_filters( 'ecs_elementor_thumbnail_size_conditions', [ 'thumbnail' => 'yes', 'thumbnail_dimensions_choice' => 'size', ] );
  • includes/elementor/elementor-widget.php line 295
    apply_filters( 'ecs_elementor_widget_atts', $atts, $settings );
  • includes/elementor/elementor-widget.php line 221
    do_action( 'ecs_elementor_widget_controls_before_advanced', $this );
  • includes/elementor/elementor-widget.php line 13
    apply_filters( 'ecs_elementor_widget_script_depends', [] );
  • ecs_end_tag

    filter
    the-events-calendar-shortcode.php line 478
    apply_filters( 'ecs_end_tag', '</ul>', $atts );
  • the-events-calendar-shortcode.php line 479
    apply_filters( 'ecs_ending_output', $output, $posts, $atts );
  • the-events-calendar-shortcode.php line 410
    apply_filters( 'ecs_event_classes', '', $atts, $post );
  • the-events-calendar-shortcode.php line 413
    apply_filters( 'ecs_event_contentorder', $atts['contentorder'], $atts, $post );
  • the-events-calendar-shortcode.php line 451
    apply_filters( 'ecs_event_date_tag_end', '</span>', $atts, $post );
  • the-events-calendar-shortcode.php line 449
    apply_filters( 'ecs_event_date_tag_start', '<span class="duration time">', $atts, $post );
  • the-events-calendar-shortcode.php line 468
    apply_filters( 'ecs_event_date_thumb', '<div class="date_thumb"><div class="month">' . tribe_get_start_date( null, false, 'M' ) . '</div><div class="day">' . tribe_get_start_date( null, false, 'j' ) . '</div></div>', $atts, $post );
  • the-events-calendar-shortcode.php line 475
    apply_filters( 'ecs_event_end_tag', '</li>', $atts, $post );
  • the-events-calendar-shortcode.php line 442
    apply_filters( 'ecs_event_excerpt', self::get_excerpt( $excerptLength ), $atts, $post, $excerptLength );
  • the-events-calendar-shortcode.php line 443
    apply_filters( 'ecs_event_excerpt_tag_end', '</p>', $atts, $post );
  • the-events-calendar-shortcode.php line 441
    apply_filters( 'ecs_event_excerpt_tag_start', '<p class="ecs-excerpt">', $atts, $post );
  • the-events-calendar-shortcode.php line 450
    apply_filters( 'ecs_event_list_details', tribe_events_event_schedule_details(), $atts, $post );
  • the-events-calendar-shortcode.php line 472
    apply_filters( "ecs_event_list_output_custom_{strtolower(trim($contentorder))}", '', $atts, $post );
  • the-events-calendar-shortcode.php line 417
    apply_filters( 'ecs_event_list_title', get_the_title(), $atts, $post );
  • the-events-calendar-shortcode.php line 461
    apply_filters( 'ecs_event_list_venue', tribe_get_venue(), $atts, $post );
  • the-events-calendar-shortcode.php line 410
    apply_filters( 'ecs_event_start_tag', '<li class="ecs-event' . implode( '', $category_slugs ) . $featured_class . apply_filters( 'ecs_event_classes', '', $atts, $post ) . '">', $atts, $post );
  • the-events-calendar-shortcode.php line 418
    apply_filters( 'ecs_event_title_tag_end', '</h4>', $atts, $post );
  • the-events-calendar-shortcode.php line 416
    apply_filters( 'ecs_event_title_tag_start', '<h4 class="entry-title summary">', $atts, $post );
  • the-events-calendar-shortcode.php line 460
    apply_filters( 'ecs_event_venue_at_tag_end', ' </em>', $atts, $post );
  • the-events-calendar-shortcode.php line 458
    apply_filters( 'ecs_event_venue_at_tag_start', '<em> ', $atts, $post );
  • the-events-calendar-shortcode.php line 459
    apply_filters( 'ecs_event_venue_at_text', __( 'at', 'the-events-calendar-shortcode' ), $atts, $post );
  • the-events-calendar-shortcode.php line 462
    apply_filters( 'ecs_event_venue_tag_end', '</span>', $atts, $post );
  • the-events-calendar-shortcode.php line 457
    apply_filters( 'ecs_event_venue_tag_start', '<span class="duration venue">', $atts, $post );
  • the-events-calendar-shortcode.php line 384
    apply_filters( 'ecs_filter_events_after_get', $posts, $atts );
  • the-events-calendar-shortcode.php line 370
    apply_filters( 'ecs_get_events_args', [ 'post_status' => 'publish', 'hide_upcoming' => true, 'posts_per_page' => $atts['limit'], 'tax_query' => $atts['event_tax'], 'meta_key' => ( ( trim( $atts['orderby'] ) and 'title' != $atts['orderby'] ) ? $atts['orderby'] : $atts['key'] ), 'orderby' => ( $atts['orderby'] == 'title' ? 'title' : 'event_date' ), 'author' => $atts['author'], 'order' => 'DESC' === strtoupper( $atts['order'] ) ? 'DES... );
  • the-events-calendar-shortcode.php line 380
    apply_filters( 'ecs_get_meta_query', [ $atts['meta_date'] ], $atts, $meta_date_date, $meta_date_compare );
  • the-events-calendar-shortcode.php line 487
    apply_filters( 'ecs_no_events_found_message', sprintf( _x( wp_kses_post( $atts['message'] ), 'A message to indicate there are no upcoming events.', 'the-events-calendar' ), tribe_get_event_label_plural_lowercase() ), $atts );
  • the-events-calendar-shortcode.php line 246
    apply_filters( 'ecs_shortcode_atts', [ 'cat' => '', 'month' => '', 'limit' => 5, 'eventdetails' => 'true', 'time' => null, 'past' => null, 'venue' => 'false', 'author' => null, 'schema' => 'true', 'message' => 'There are no upcoming %1$s.', 'key' => 'End Date', 'order' => 'ASC', 'orderby' => 'startdate', 'viewall' => 'false', 'excerpt' => 'false', 'thumb' => 'false', 'thumbsize' => '', 'thumbwidth' => '', 'thumbheight' => '', 'con... );
  • the-events-calendar-shortcode.php line 476
    apply_filters( 'ecs_single_event_output', $event_output, $atts, $post, $post_index, $posts, $content );
  • the-events-calendar-shortcode.php line 397
    apply_filters( 'ecs_skip_event', false, $atts, $post );
  • ecs_start_tag

    filter
    the-events-calendar-shortcode.php line 390
    apply_filters( 'ecs_start_tag', '<ul class="ecs-event-list">', $atts, count( (array) $posts ), $content );
  • the-events-calendar-shortcode.php line 484
    apply_filters( 'ecs_view_all_events_tag_end', '</span></div>' );
  • the-events-calendar-shortcode.php line 482
    apply_filters( 'ecs_view_all_events_tag_start', '<div class="ecs-view-all-events"><span class="ecs-all-events">', $atts );
  • the-events-calendar-shortcode.php line 483
    apply_filters( 'ecs_view_all_events_text', sprintf( __( 'View all %s', 'the-events-calendar' ), tribe_get_event_label_plural_lowercase() ), $atts );
  • tracking/class-plugin-usage-tracker.php line 615
    apply_filters( "wisdom_delay_notification_{$this->plugin_name}", 0 );
  • tracking/class-plugin-usage-tracker.php line 169
    apply_filters( "wisdom_filter_schedule_{$this->plugin_name}", 'monthly' );
  • tracking/class-plugin-usage-tracker.php line 977
    apply_filters( "wisdom_form_text_{esc_attr($this->plugin_name)}", $form );
  • tracking/class-plugin-usage-tracker.php line 815
    apply_filters( "wisdom_is_local_{$this->plugin_name}", $is_local );
  • tracking/class-plugin-usage-tracker.php line 909
    apply_filters( "wisdom_marketing_text_{esc_attr($this->plugin_name)}", $marketing_text );
  • tracking/class-plugin-usage-tracker.php line 860
    apply_filters( "wisdom_notice_text_{esc_attr($this->plugin_name)}", $notice_text );

Generated from The Events Calendar Shortcode & Block's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.

Can't find the right hook?

We can build the customisation for you. Describe what you need: