StatusEnumeration
StatusEnumeration groups every lifecycle-state vocabulary in schema.org under Enumeration. Subtypes: ActionStatusType (Potential/Active/Completed/Failed), EventStatusType (Scheduled/Cancelled/Postponed/Rescheduled/MovedOnline), OrderStatus, PaymentStatusType, ReservationStatusType, LegalForceStatus, GameServerStatus, IncentiveStatus.
Full example of schema.org/StatusEnumeration json-ld markup
The markup is verified as valid with Rich Results Test from Google.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Event",
"name": "Copenhagen Marathon 2026",
"startDate": "2026-05-17",
"eventStatus": "https://schema.org/EventScheduled"
}
</script>Minimal valid version
The smallest markup that still produces a valid StatusEnumeration entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Event",
"eventStatus": "https://schema.org/EventScheduled"
}
</script>Google rich results this unlocks
StatusEnumeration is a structural type. It does not produce a rich result on its own.
Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). StatusEnumeration becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.
Common StatusEnumeration mistakes
Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.
- 01
Typing a status as bare StatusEnumeration
Wrong"eventStatus": { "@type": "StatusEnumeration", "name": "Scheduled" }Right"eventStatus": "https://schema.org/EventScheduled"Status values are URIs from the specific subtype. A bare StatusEnumeration is never the right assignment.
Schema properties in this example
Also mentioned in 5 other examples
StatusEnumeration also appears in ActionStatusType, EventStatusType, GameServerStatus, PaymentStatusType, and ReservationStatusType. See the full StatusEnumeration schema page for every reference.
About the example data
Parent of every "what state is this in?" enum across Event, Order, Reservation, Payment, and Action markup.
Comments
Loading comments...