Skip to content
Tickets Please

Widgets

Widgets

Sidebars, footers, and widget-ready areas are prime spots for keeping upcoming events visible across your site. Tickets Please includes two widgets that you can add to any widget area in your theme. Both work with the classic widget editor and the block-based widget editor introduced in WordPress 5.8.

Events List Widget

Widget ID: tec_events_list

Displays a compact list of upcoming events in any widget area. This is the same output as the [tribe_events_list] shortcode, packaged as a drag-and-drop widget.

Options

SettingValuesDefaultDescription
TitleText”Upcoming Events”The widget heading displayed above the event list
Number of events1-105How many upcoming events to show
Show dateCheckboxCheckedDisplay the event start date next to each event
Show venueCheckboxCheckedDisplay the venue name next to each event
Category filterDropdownAllLimit the list to events in a specific category

Output

The widget renders an unordered list (<ul>) of upcoming events. Each list item contains the event title linked to the event page, with the date and venue below it if those options are enabled. Events are ordered by start date, soonest first. Past events are excluded.

Typical Uses

  • Blog sidebar: Show readers what events are coming up while they browse posts.
  • Homepage widget area: Feature upcoming events on the front page without building a custom template.
  • Footer columns: Add event listings alongside contact info and social links in a multi-column footer.

Widget ID: tec_footer_nav

Adds event archive navigation links to any widget area. This is a simple set of links for visitors who want to browse events by different views or categories.

Output

The widget renders three links:

  • Events Archive — links to the main events page (/events/)
  • Month View — links to the current month’s calendar view
  • Categories — links to a list of all event categories

No configuration options are needed. The widget uses your site’s events URL slug and generates the correct links automatically.

Typical Uses

  • Footer widget area: Provide event navigation in the site footer alongside other site links.
  • Secondary sidebar: Give visitors quick access to event browsing from any page.

Adding Widgets to Your Site

Block-Based Widget Editor (WordPress 5.8+)

  1. Go to Appearance > Widgets in your WordPress admin.
  2. Click the + block inserter in the widget area where you want to add the widget.
  3. Search for “Events List” or “Footer Nav” under the Tickets Please category.
  4. Click the widget to add it.
  5. Configure the options in the block settings sidebar.
  6. Click Update to save.

Classic Widget Editor

If your theme uses the classic widget editor or you have the Classic Widgets plugin installed:

  1. Go to Appearance > Widgets.
  2. Find Events List or Footer Nav in the Available Widgets column.
  3. Drag the widget into the desired widget area.
  4. Configure the settings and click Save.

Shortcode Alternative

The Events List Widget and the [tribe_events_list] shortcode produce the same output. If your theme does not have widget areas where you need them, or if you prefer embedding the list directly in page content, use the shortcode instead. See the Shortcodes Reference for details.

Common Questions

Can I show events from multiple categories in one widget? The category filter supports one category at a time. To show events from multiple categories, add multiple widget instances, each filtered to a different category.

Do widgets update automatically when I add new events? Yes. Widgets pull live data from your events each time the page loads. New events appear and past events drop off automatically.

Can I style the widget output with CSS? Yes. The Events List Widget outputs HTML with CSS classes following the tec- prefix convention. Target .tec-events-list-widget and its child elements in your theme’s stylesheet.

Why don’t I see the widgets in my widget area? Make sure Tickets Please is activated. If you use a block theme with Full Site Editing, widgets are managed through the Site Editor instead of the Widgets screen. Go to Appearance > Editor and add the widget block to your template.

Is there a Mini Calendar widget? A dedicated Mini Calendar widget is not currently available. Use the [tribe_mini_calendar] shortcode or the Mini Calendar Gutenberg block to add a compact calendar to your pages.

Next Steps