# Events

<table><thead><tr><th width="206">Parameter</th><th width="264">Options</th><th width="225">Description</th></tr></thead><tbody><tr><td>format</td><td>horizontal, live-session, on-demand, agenda, calendar, wave-card, null</td><td>Specifies the event layout format. horizontal supports highlighting via highlight_position.</td></tr><tr><td>width</td><td>full, 1/2, 1/3, 1/4</td><td>Defines the width of the event display.</td></tr><tr><td>highlight_position</td><td>Numerical (e.g., 1, 2)</td><td>Sets the position of the highlighted event. Works only with the horizontal format.</td></tr><tr><td>include</td><td>main_only, all</td><td>Determines whether to display only main events or include all events. Ignored if event_id is provided.</td></tr><tr><td>event_id</td><td>Numerical (e.g., 1)</td><td>Displays sub-events of a specific event.</td></tr><tr><td>lang</td><td>en, pt, es, cn, kr, all</td><td>Filters events by language.</td></tr><tr><td>date</td><td>upcoming, past, all</td><td>Filters events by date. Defaults to upcoming.</td></tr><tr><td>day</td><td>Specific date (YYYY-MM-DD, e.g., 2021-06-21)</td><td>Retrieves events occurring on the specified date.</td></tr><tr><td>terms</td><td>Numerical list (e.g., 1,2,3)</td><td>Filters events based on specific terms (comma-separated).</td></tr><tr><td>terms_operator</td><td>and, or</td><td>Defines how terms are combined for filtering. Defaults to and.</td></tr><tr><td>limit</td><td>Numerical (e.g., 5)</td><td>Limits the number of events displayed. Also applies to the number of items per page if pagination is enabled.</td></tr><tr><td>list_unconnected</td><td>yes, no (default: no)</td><td>Includes or excludes events not connected to other entities.</td></tr><tr><td>paginate</td><td>yes</td><td>Enables pagination. Remove this parameter if pagination is not required.</td></tr><tr><td>channel_id</td><td>Numerical (e.g., 1)</td><td>Lists events assigned to a specific channel.</td></tr><tr><td>exclude_channel_id</td><td>Numerical (e.g., 1)</td><td>Excludes events assigned to a specific channel.</td></tr><tr><td>event_type</td><td>single-session, multi-session, super-event</td><td>Filters events by type.</td></tr><tr><td>event_format</td><td>broadcast, meeting</td><td>Filters events by format.</td></tr><tr><td>event_badges</td><td>Comma-separated list (e.g., webinar,conference)</td><td>Filters events by badges.</td></tr><tr><td>no_results_message</td><td>Text</td><td>Customizes the message displayed if no events are found.</td></tr><tr><td>attendance_mode</td><td>remote, in_person, hybrid</td><td>Filters events by attendance mode.</td></tr></tbody></table>

{% hint style="warning" %}
By default, only **upcoming events** are shown. If you want to include past events or a series, specify `date="all"` to ensure they remain visible.
{% endhint %}

***

#### **Shortcode Examples**

**1. Highlighted Horizontal Layout**

```plaintext
[events 
    format="horizontal" 
    highlight_position="2" 
    date="upcoming" 
    limit="3"]
```

<figure><img src="https://45522127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS512VHdqGC4MSzdDrKgr%2Fuploads%2FFV0dq8b5S6oHNv5VDX4L%2Fscreencapture-test-wavecast-io-demo-events-papillon-preview-widgets-16872-2024-11-28-11_47_39.png?alt=media&#x26;token=76525074-4cf7-4bea-b8b2-5f9a62fbbea4" alt=""><figcaption></figcaption></figure>

**2. Display Marketing Webinars Only**

```plaintext
[events terms="marketing"]
```

**3. Past Sub-events for a Super Event**

```plaintext
[events 
    display="all"
    event_id="123"]
```

<figure><img src="https://45522127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS512VHdqGC4MSzdDrKgr%2Fuploads%2FYNijOLZniICsRQttWwOh%2Fsuper-events.png?alt=media&#x26;token=1480c6f9-391c-4e2d-adf1-a5d1945eebd3" alt=""><figcaption></figcaption></figure>

**4. Upcoming Events with Pagination**

```plaintext
[events 
    format="horizontal"
    date="upcoming" 
    paginate="yes"]
```

<figure><img src="https://45522127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FS512VHdqGC4MSzdDrKgr%2Fuploads%2FN5rI9wKsR03wOhoA6t24%2Fscreencapture-engineering-futures-co-uk-webinars-2024-11-28-11_49_21.png?alt=media&#x26;token=2b464412-30ab-405d-82dc-6d640aaef489" alt=""><figcaption></figcaption></figure>
