Open Evnt
Open Evnt is a specification for representing, publishing, discovering social events on the web.
It provides a modern JSON data format for rich event details alongside a lightweight discovery and indexing protocols that allow events to be shared across apps and websites.
Open Evnt addresses three major problems in event management and sharing:
- Data-stuffing: Existing event formats force multi-day or complex event schedules into rigid fields. Unstructured details get dumped into description fields where applications can't process them. Open Evnt models events as they actually exist - with support for partial dates, multiple dates, multi-language content, and extensible component blocks that allow for rich, structured event information.
- Fragmentation: Without an open standard for rich event data, every website, ticket platform, conference app, and social network uses its own format gated behind proprietary APIs. Event data is siloed and cannot be shared or reused across platforms. Open Evnt creates a single, shared format that can be used for seamless interoperability between applications and services.
- Discoverability: Finding and subscribing to structured event feeds today requires custom API integrations or static, unqueryable
.icsfiles. Open Evnt provides protocols for publishing and discovering event collections allowing applications to query and filter events across the web in a standardized way.
The Open Evnt Stack
Open Evnt consists of three complementary specifications:
- Open Evnt Event - The primary JSON schema for modelling events in high detail.
- Open Evnt Manifest - A well-known domain endpoint for exposing available event collections.
- Open Evnt Index - A filterable, paginated index format for querying events.
An Example Event
json
{
"v": "0.2",
"id": "https://example.com/events/summer-workshops-2026",
"name": {
"en": "Summer Workshop Series 2026",
"fr": "Ateliers d'été 2026",
"de": "Sommer-Workshop-Reihe 2026"
},
"venue": {
"name": { "de": "Volkspark Friedrichshain" },
"address": "Berlin",
"countryCode": "DE"
},
"occurrences": [{ "start": "2026-07[Europe/Berlin]" }],
"components": [
{
"$type": "directory.evnt.richtext.markdown#0",
"content": "An example description!",
"flavor": "gfm"
},
{
"$type": "directory.evnt.component.link#0",
"url": "https://example.com/summer-workshops"
}
]
}Summer Workshop Series 2026
July 2026, Volkspark Friedrichshain, Berlin
An example description!
Link: example.com/summer-workshops
Start here
- Try it in the Playground
- Pick your use case: a calendar app, a convention website, a ticketing site or an event directory
- Read the Event Specification
- Read the Manifest Specification
- Read the Index Specification
Contributing
Feedback, contributions, and questions are welcome! Join our Discord or Matrix to discuss Open Evnt with the community.