Note: you are viewing the development version of schema.org. See How we work for more details.

eventSchedule

This term is proposed for full integration into Schema.org, pending implementation feedback and adoption from applications and websites.

Thing > Property > eventSchedule

Associates an Event with a Schedule. There are circumstances where it is preferable to share a schedule for a series of repeating events rather than data on the individual events themselves. For example, a website or application might prefer to publish a schedule for a weekly gym class rather than provide data on every event. A schedule could be processed by applications to add forthcoming events to a calendar. An Event that is associated with a Schedule using this property should not have startDate or endDate properties. These are instead defined within the associated Schedule, this avoids any ambiguity for clients using the data. The property might have repeated values to specify different schedules, e.g. for different months or seasons.
Values expected to be one of these types
Schedule
Used on these types
Event

Source

https://github.com/schemaorg/schemaorg/issues/1457

Examples

Example 1
Without Markup Microdata RDFa JSON-LD 
A Tai-Chi class runs throughout 2017. The class occurs weekly, every Wednesday at 7pm.

Example is JSON-LD only.

Example is JSON-LD only.

<script type="application/ld+json">
{
  "@context": "http://schema.org/",
  "@type": "Event",
  "url": "http://www.example.org/events/1",
  "name": "Tai chi Class",
  "description": "A weekly Tai-Chi class",
  "duration": "PT60M",
  "eventSchedule": {
     "@type": "Schedule",
     "startDate": "2017-01-01",
     "endDate": "2017-12-31",
     "repeatFrequency": "P1W",
     "byDay": "http://schema.org/Wednesday",
     "startTime": "19:00",
     "endTime": "20:00",
     "scheduleTimezone": "Europe/London"
  }
}
</script>
Example 2
Without Markup Microdata RDFa JSON-LD 
A Meetup takes place on the 1st and 15th of every month between 9-10am

Example is JSON-LD only.

Example is JSON-LD only.

<script type="application/ld+json">
{
  "@context": "http://schema.org/",
  "@type": "Event",
  "name": "Example Meetup",
  "eventSchedule": {
     "@type": "Schedule",
     "repeatFrequency": "P1M",
     "byMonthDay": [1,15],
     "startTime": "09:00",
     "endTime": "10:00",
     "scheduleTimezone": "America/Glace_Bay"
  }
}
</script>
Example 3
Without Markup Microdata RDFa JSON-LD 
Starting from 2th December an Event will run daily between 9-10am for 10 occurences.

Example is JSON-LD only.

Example is JSON-LD only.

<script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "Event",
      "name": "Count Example",
      "eventSchedule":
        {
          "@type": "Schedule",
          "startDate": "2016-12-24",
          "repeatFrequency": "P1D",
          "repeatCount": 10,
          "startTime": "09:00",
          "endTime": "10:00",
          "scheduleTimezone": "Europe/London"
        }
    }
</script>
Example 4
Without Markup Microdata RDFa JSON-LD 
An Event runs twice a day, at 9am-10am and 2pm-3pm but only Monday to Friday

Example is JSON-LD only.

Example is JSON-LD only.

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Event",
  "name": "Example",
  "eventSchedule": [
    {
      "@type": "Schedule",
      "repeatFrequency": "P1D",
      "byDay": [
        "http://schema.org/Monday",
        "http://schema.org/Tuesday",
        "http://schema.org/Wednesday",
        "http://schema.org/Thursday",
        "http://schema.org/Friday"
      ],
      "startTime": "09:00",
      "endTime": "10:00",
      "scheduleTimezone": "America/Glace_Bay"
    },
    {
      "@type": "Schedule",
      "repeatFrequency": "P1D",
      "byDay": [
        "http://schema.org/Monday",
        "http://schema.org/Tuesday",
        "http://schema.org/Wednesday",
        "http://schema.org/Thursday",
        "http://schema.org/Friday"
      ],
      "startTime": "14:00",
      "endTime": "15:00",
      "scheduleTimezone": "America/Glace_Bay"
    }
  ]
}
</script>
Example 5
Without Markup Microdata RDFa JSON-LD 
An Event runs on the second Monday of every month, from 6pm-7:30pm. Because this kind of recurrence goes beyond that expressible using <a href="http://schema.org/DayOfWeek">http://schema.org/DayOfWeek</a>, it is specified instead using iCal's <a href="https://icalendar.org/iCalendar-RFC-5545/3-8-5-3-recurrence-rule.html">syntax for byDay recurrence rules</a>.

Example is JSON-LD only.

Example is JSON-LD only.

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "Event",
  "name": "Example",
  "eventSchedule": [
    {
      "@type": "Schedule",
      "repeatFrequency": "P1M",
      "byDay": "2MO",
      "startTime": "18:00",
      "endTime": "19:30",
      "scheduleTimezone": "Asia/Shanghai"
    }
  ]
}
</script>