> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> Events you type in the theme editor, with kind filters, past evenings, Add to calendar and a reply form. An alternative to the events blog.

![Events on the storefront](https://mintcdn.com/kwebby/l0HCHOt6KIWLP9LZ/images/vesper/events.webp?fit=max\&auto=format\&n=l0HCHOt6KIWLP9LZ\&q=85\&s=382576e11b2db157dd04209990c69f3e)

Events, highlighted with the demo content

## Where to find it

The Events template (page.events). In the theme editor choose Pages, then events, and select Events.

## How it works

* Each Event block is one event with a start, an optional end, title, kind, place, photograph and description.
* Each event moves to Past evenings by itself once its end has passed.
* Filters by kind appear when events have two or more kinds.
* Replies are contact form messages that name the event. No booking, seat count or payment is involved.

![Events in the theme editor](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/editor-events.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=14ac196d5ded95751b82c88cefbad8b6)

In the theme editor: 1 the section in the sidebar · 2 its settings · 3 the section in the preview

## Edit it

* Add an Event block per event, in date order (up to 40 blocks in all).
* Type Starts with the date, time and time zone offset, for example 2026-11-20T19:00-05:00, or the date alone for an all-day event.
* Add Reply form field blocks for the reply form.
* Edit Heading, the past events heading and link, and the reply form texts.

## Settings

| Setting | What it does |
| - | - |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 1. |

> [!TIP]
>
> Add events in date order. Each moves to Past events by itself once its end has passed. Replies are sent to you as contact form messages, with the event named; confirm each place by email.

| Setting | What it does |
| - | - |
| **Heading** | Text. Default: Coming up. |
| **Show filters by kind** | On or off. Appears when events have two or more kinds. Default: on. |
| **Show Add to calendar** | On or off. Downloads a calendar file with the event's date, time and place. Default: on. |
| **Text when nothing is planned** | Text. Default: There are no events planned just now. |
| **Link label when nothing is planned** | Text. Default: Ask to be invited to the next one. |
| **Link when nothing is planned** | Link: a page, product, collection or web address. |

**Past events**

| Setting | What it does |
| - | - |
| **Show past events** | On or off. Default: on. |
| **Heading** | Text. Default: Past evenings. |
| **Link label** | Text. Default: Photographs from the salons. |
| **Link** | Link: a page, product, collection or web address. |

**Reply form**

| Setting | What it does |
| - | - |
| **Heading** | Text. Default: Reply to the invitation. |
| **Introduction** | Text. |
| **Button label** | Text. Default: Send my reply. |
| **Note under the button** | Text. Default: Replies are requests: the salon confirms each place by email. |
| **Message after sending** | Text. Default: Thank you. The salon will confirm your place by email within two working days. |

## Blocks

Up to 40 blocks. Add a block with **Add block** under the section in the sidebar; drag blocks to reorder them.

### Event

| Setting | What it does |
| - | - |
| **Title** | Text. Default: An evening in the salon. |
| **Starts** | Text. Date, time and time zone offset in this order: 2026-11-20T19:00-05:00. For an all-day event, the date alone: 2026-11-20. |
| **Ends** | Text. Optional, in the same format. For a show over several days, the last day. |
| **Kind** | Text. For example Salon evening, Trunk show or Exhibition. Default: Salon evening. |
| **Place** | Text. Default: The salon, New York. |
| **Place link** | Link: a page, product, collection or web address. For example your boutiques page with #boutique-new-york. |
| **Photograph** | Image: upload one or choose from Content → Files. |
| **Description** | Formatted text. |
| **Show reply button** | On or off. Default: on. |
| **Reply button label** | Text. Default: Reply to the invitation. |

### Reply form field

| Setting | What it does |
| - | - |
| **Label** | Text. Also names the answer in the email you receive. Default: Name. |
| **Type** | Options: Text, Email, Telephone, Long text, Choice list, Checkbox. Default: Text. |
| **Choices** | Text (several lines). One choice per line. |
| **Required** | On or off. Default: off. |
| **Help text** | Text. |
| **Placeholder** | Text. |
| **Maximum characters** | Number. Default: 200. |
| **Width** | Options: Full, Half. Default: Full. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.