> ## 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 blog

> A blog where each post is an event: date tiles, kind and place, Add to calendar and a reply form, with upcoming and past events.

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

Events blog, highlighted with the demo content

## Where to find it

A blog that uses the blog.events template. In the theme editor choose Blogs, then events, and select Events blog.

## How it works

* Each post is one event. Its start and end come from the article metafields custom.start and custom.end, or from tags such as date:2026-11-20T19:00-05:00 and end:2026-11-20T21:30-05:00.
* Its place comes from custom.location or a tag such as place:New York, and its kind from custom.event\_type or a tag such as kind:Trunk show.
* Events sort by date. Past events get an Archive label, lose the reply button and move under Archive.
* The reply button opens a form in a dialog. Replies arrive as contact form messages that name the event. Confirm each place by email.
* Add to calendar downloads a calendar file with the date, time and place.
* A place that matches a boutique's city links to that boutique on your Boutiques page.

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

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

## Edit it

* Create a blog called Events and set its template to blog.events.
* Set Boutiques page so places link to their boutique.
* Add Reply form field blocks for the reply form (name, email, guests and so on).
* Edit Introduction, the empty-state text and the reply form heading, note and thank-you message.

## Settings

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

> [!TIP]
>
> Each post in this blog is an event. Give it tags in this format: date:2026-11-20T19:00-05:00 for the start, end:2026-11-20T21:30-05:00 for the end, place:New York for the boutique and kind:Trunk show. Tags with a colon are hidden from shoppers.

| Setting | What it does |
| - | - |
| **Show breadcrumbs** | On or off. Default: on. |
| **Introduction** | Formatted text (one line). |
| **Show excerpts** | On or off. Default: on. |
| **Show reply buttons** | On or off. Replies are sent to you as contact form messages, with the event named. Default: on. |
| **Show Add to calendar** | On or off. Default: on. |
| **Boutiques page** | Choose a page. Links each place to its boutique. The place tag must match the boutique's city, for example place:New York. |
| **Events per page** | Slider from 6 to 36, in steps of 6. Default: 24. |
| **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. |

**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 12 blocks. Add a block with **Add block** under the section in the sidebar; drag blocks to reorder them.

### 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. |

> [!NOTE]
>
> See [Boutiques and events](https://docs.kwebby.com/gloaming/guides/boutiques-and-events.md) for the full set-up.


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