> For the complete documentation index, see [llms.txt](https://docs.wavecast.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wavecast.io/publishing/shortcodes/events-with-search-bar.md).

# Events with Search Bar

Before using the `[events_with_search_bar]` shortcode, you need to configure your settings under *Event listing settings* 

<figure><img src="/files/YEnvDz6jvBg63QN76hLv" alt=""><figcaption></figcaption></figure>

You can also display Taxonomy Filters by adjusting *Display Global Filter* and *Display Taxonomy Groups*. More information on how to configure taxonomies for events can be found [here](/publishing/classify-and-personalise/create-and-configure-taxonomies.md).

This can be found under *Settings* > *Event Settings*

<figure><img src="/files/R2egVtFnvwVe01fE497H" alt=""><figcaption></figcaption></figure>

When placed, it will render your events like so:<br>

<figure><img src="/files/lQ3gkbwmdjeBVQFDPXDe" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
When your event is live, a badge will display indicating this. If you would like this to be removed please contact us a <clients@wavecastpro.com> and we will remove it with custom CSS
{% endhint %}

<figure><img src="/files/gud01Y0DgT0JpVm4xSaS" alt=""><figcaption></figcaption></figure>

These are the following parameters which are accepted:

<table><thead><tr><th width="130">Parameter</th><th width="134">Type</th><th width="494">Description</th></tr></thead><tbody><tr><td><code>page_id</code></td><td>String (default: '1')</td><td>Specifies the page ID of the pagination for the event listing. This parameter determines the specific page to display events on. If not set, defaults to page 1.</td></tr><tr><td><code>attendance_mode</code></td><td>Array (default: null)</td><td>Defines the attendance modes for filtering events. Accepts a comma-separated list (e.g., remote,in_person). If set to null, no filtering by attendance mode is applied.</td></tr></tbody></table>