# 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="/files/5qGWVTrSSJYl2NJWAm5R" 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="/files/GXmVOrE2HvQd6LWnW7Yv" alt=""><figcaption></figcaption></figure>

**4. Upcoming Events with Pagination**

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wavecast.io/publishing/shortcodes/events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.