title: "Event" post_status: publish comment_status: open taxonomy: category: - yoast-developer post_tag: - Pieces - Schema - Features
import YoastSchemaExample from '../../../../src/components/YoastSchemaExample';
描述一个 Event，它在特定时间和地点发生，并可包含额外的可选信息。
触发条件
当页面内容描述一个事件时，应将其作为图谱中的顶级节点添加。
必需属性
一个有效的 Event 必须包含以下属性。
@type:Event。@id: 网站的首页 URL 后追加#/schema/Event/{{ID}}，其中{{ID}}是一个唯一标识符。name: 命名该事件的字符串。location: 一个Place或VirtualLocation节点，描述事件发生的地点。startDate: 事件的开始日期和时间，采用 ISO-8601 格式（包含 UTC 时区偏移量）。
可选属性
以下属性在可用且有效时应添加：
description：描述或总结事件的文本字符串。endDate：事件的结束日期和时间，采用 ISO-8601 格式（包含 UTC 时区偏移量）。eventAttendanceMode：一个EventAttendanceModeEnumeration，反映事件的出席模式（OfflineEventAttendanceMode、OnlineEventAttendanceMode或MixedEventAttendanceMode）。image：一个代表事件的imageObject（或imageObject数组），通过 ID 引用。organizer：负责组织事件的Organization或Person。performer：在事件中表演的Person（或Person数组）。
条件属性
当活动在实体地点（或“线下”）举行时
location.name: 活动地点/场馆的名称。location.address: 活动地点/场馆的PostalAddress。
当活动为“虚拟”（或“在线”）时
location.url：活动将举行的 URL。
当活动已取消时
eventStatus：一个EventStatusType枚举，设置为EventCancelled。
当活动已重新安排时
eventStatus：一个EventStatusType枚举，设置为EventRescheduled。previousStartDate：活动之前的开始日期（或之前开始日期的数组），格式为 ISO-8601（包含 UTC 时区偏移）。
当事件包含一个或多个“优惠”时（例如，售票活动）
offers: 一个Offer（或一个Offer数组）。
失败场景
如果 Event 的任何必填字段缺失或无效，则不应输出该节点。
如果未输出某个节点，任何原本会声明与其存在关系的实体都应移除这些引用。
Examples
Minimum criteria
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Event",
"@id": "https://www.example.com/#/schema/Event/abc123",
"name": "My awesome party",
"location": {
"@type": "Place",
"name": "Example Venue",
"address": {
"@type": "PostalAddress",
"@id": "https://www.example.com/#/schema/PostalAddress/abc123",
"streetAddress": "123 Example Street",
"addressLocality": "Example Town",
"addressRegion": "Example Region",
"postalCode": "ABC 123",
"postOfficeBoxNumber": "123",
"addressCountry": "US"
}
},
"startDate": "2025-07-21T19:00-05:00"
}
]
}}
Extended criteria
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Event",
"@id": "https://www.example.com/#/schema/Event/abc123",
"name": "My birthday party",
"description": "We're all getting together in at Example Venue in Fake Town to celebrate my special day!",
"location": {
"@type": "Place",
"name": "Example Venue",
"address": {
"@type": "PostalAddress",
"streetAddress": "123 Fake Street",
"addressLocality": "Fake Town",
"postalCode": "12345",
"addressRegion": "XY",
"addressCountry": "US"
}
},
"startDate": "2025-07-21T19:00-05:00",
"endDate": "2025-07-22T19:00-05:00",
"eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
"eventStatus": "https://schema.org/EventRescheduled",
"previousStartDate": "2024-07-21T19:00-05:00",
"offers": {
"@type": "Offer",
"@id": "https://www.example.com/#/schema/Offer/abc123",
"priceSpecification": {
"@type": "PriceSpecification",
"price": "22.00",
"valueAddedTaxIncluded": "false",
"priceCurrency": "GBP"
},
"availability": "http://schema.org/InStock",
"url": "https://www.example.com/example-product-page/",
"seller": {
"@id": "https://www.example.com/#/schema/Organization/1"
}
},
"image": {
"@id": "https://www.example.com/uploads/example-image.jpg"
},
"organizer": {
"@id": "https://www.example.com/#/schema/Organization/1"
},
"performer": {
"@id": "https://www.example.com/#/schema/Person/abc123"
}
}
]
}}