Implementing Schema.org Data Models

Overview

Schema.org is the internet's standard for structured data. Adopting it prevents "bikeshedding" over field names and ensures our data is ready for SEO, AI agents, and external integrations (like calendars) from day one.

Core Principle: If Schema.org has a standard for it, use it. Do not invent your own field names.

When to Use

• Creating a new Collection (e.g., Venues, Events, Users)
• Defining API responses
• Mapping data for export

The Rules

1. Strict Naming: Use the exact property name from Schema.org (e.g., postalCode not zip, givenName not firstName).
2. Preserve Structure: If Schema.org defines a property as a nested Type (like address -> PostalAddress), you MUST nest it. Do not flatten it for convenience.
3. Use Standard Types: Map your entities to the most specific Schema.org Type available (e.g., Event -> SocialEvent if applicable).