# Events card

> Canonical HTML: https://screenrig.ai/docs/cards/events/

A calendar's coming days: what is happening now, what is next, and the agenda. A door sign for a room, or a week at a glance.

Category: Events. Tags: Schedules, Events and venues, Lobbies and reception, Offices and workplaces, Schools and campuses.

## Previews

![Events](/cards/events/v1/screenshots/canvas-bloom.webp?sha=7f804c60460c4aaab9482e56dc980367f3df7b6734d31002faa45f44b2d0cd6e)

Canvas

![Events](/cards/events/v1/screenshots/corner-bloom.webp?sha=1536d34d47dd7120440c4ecaa2fbc5d9ae0a6f5bf5eeebdeac01fda4364e3114)

Corner

![Events](/cards/events/v1/screenshots/chip-bloom.webp?sha=0227671f716dc0631335c96d86b39704b4dff93ee4ecf9ec839b6a19ff741660)

Chip

## Views and forms

Views: canvas, corner, chip. Canvas forms: landscape, portrait.

[Card views, themes and publishing](/docs/cards/). [Browse the gallery](/apps/#cards).

## Data and privacy

Feed: `screenrig.events/v1`.

Feed documents carry source attribution. The Player supplies the feed to the card.

## Properties

For theme, background, accent and position, see [Common properties](/docs/cards/#common-properties).

Set static properties in `params`. Bind `data` to a project card data key for live values; that document holds only dynamic properties. Without a data key, put the complete configuration in `params`. Nested rows describe the contents of their parent property.

### Static properties

| Name | Type | Default | Values and limits | Description |
| --- | --- | --- | --- | --- |
| `title` | string | `""` | maxLength: `60` | Empty uses the calendar's name. |
| `days` | integer | `7` | minimum: `1`; maximum: `14` |  |
| `layout` | string | `"auto"` | `"auto"`, `"agenda"`, `"next"`, `"week"` |  |
| `maxEvents` | integer | `8` | minimum: `1`; maximum: `20` |  |
| `hour12` | boolean | `false` |  |  |
| `showLocation` | boolean | `true` |  |  |
| `timeZone` | string, null | `null` |  | IANA zone; null uses the screen's zone. |

### Dynamic properties

This card has no dynamic properties.

## Canvas example

Add this item to a playlist page’s `primitives`. [Publish the playlist and assign a screen](/docs/cards/#publish-a-card-canvas).

```json
{
  "id": "events",
  "primitive": "card",
  "card": "events",
  "major": 1,
  "params": {
    "theme": "neomustard"
  },
  "rect": {
    "x": 0,
    "y": 0,
    "width": 1920,
    "height": 1080
  },
  "layer": 0,
  "content_fit": "fill"
}
```