Home / Documentations / CODEX / How to Customizing the Upcoming Events List on Event Taxonomy Archive Pages

How to Customizing the Upcoming Events List on Event Taxonomy Archive Pages

Last Updated: February 11, 2026

EventON displays a list of upcoming events on taxonomy archive pages (e.g. event types, event location, event organizer etc.) using a shortcode. You can customize this list — number of events, layout, images, lightbox behavior, etc. — without modifying the plugin.

How it works

EventON provides the filter `evo_tax_archieve_page_shortcode` that lets you modify the shortcode arguments right before the upcoming events list is rendered.

Filter signature: 

add_filter( 'evo_tax_archieve_page_shortcode', 'your_function_name', 10, 3 );
function your_function_name( $shortcode_args, $taxonomy_slug, $term_id ) { 
  // modify $shortcode_args here return $shortcode_args; 
}
  • $shortcode_args — array of shortcode parameters (what you want to change)
  • $taxonomy_slug — current taxonomy (event_type, event_location, event_organizer, etc.)
  • $term_id — ID of the current term/archive being viewed

Where to place the code

Paste your custom code in one of these locations (best practice order):

  1. Child theme’s functions.php
  2. Custom functionality plugin
  3. Code Snippets plugin (recommended for non-developers)

Example: Basic customization

add_filter('evo_tax_archieve_page_shortcode', 'customize_eventon_tax_upcoming', 10, 3);

function customize_eventon_tax_upcoming($args, $taxonomy, $term_id) {

    // Apply changes to all taxonomy archive pages
    $args = array_merge($args, [
        'number_of_months'   => 6,           // look ahead 6 months
        'event_count'        => 10,          // show max 10 events
        'show_et_ft_img'     => 'yes',       // display featured images
        'eventtop_style'     => '2',         // clean / minimal layout
        'hide_mult_occur'    => 'yes',       // hide duplicate repeating events
        'hide_empty_months'  => 'yes',
        'ux_val'             => '3',         // open events in lightbox
        'show_location'      => 'yes',
        'show_etime'         => 'yes',       // show end time
        'show_year'          => 'no',
    ]);

    return $args;
}

Conditional customization (recommended for most projects)

Apply changes only to specific taxonomies or even specific terms.

Example: Different style only for event locations

add_filter('evo_tax_archieve_page_shortcode', 'custom_location_archive_events', 10, 3);

function custom_location_archive_events($args, $taxonomy_slug, $term_id) {
    if ($taxonomy_slug !== 'event_location') {
        return $args;
    }

    $args['eventtop_style']     = '0';          // boxed style
    $args['show_et_ft_img']     = 'yes';
    $args['number_of_months']   = 4;
    $args['event_count']        = 8;
    $args['show_location']      = 'no';         // redundant on location archive
    $args['ux_val']             = '3a';         // lightbox + external link when available

    return $args;
}

Most useful shortcode parameters for taxonomy archives

ParameterCommon ValuesPurpose
number_of_months3-12Months to display ahead
event_count5-20Maximum total events to show
hide_mult_occuryes / noHide duplicate occurrences of repeating events
show_et_ft_imgyes / noShow featured image on event top
eventtop_style1, 21 = Colorful EventTop, 2 = Colorful with gap between. etc.,
ux_valX, 2, 3, 3aClick behavior: 3 = lightbox, 3a = ajax lightbox
hide_empty_monthsyes / noSkip months with no events
show_yearyes / noShow year in month headings

Read Shortcode Guide for more Shortcode Parameters.

Tips

  • Use event_count when you want a fixed number of events instead of time-based.
  • Combine hide_mult_occur=yes with event_count for cleaner lists.
  • Test lightbox behavior (ux_val) — 3 is usually the best balance.
  • If you want completely different content, consider overriding the template instead of just modifying the shortcode.

Did this article help you?

Ready to Start Your Calendar?

65k+ Sites Use EventON

Start with Lite

Download Free

Or

Go Pro

Buy Full