Publishing Data
Using data
Open Booking API
Specifications
Opening Hours
Implementation of the proposal for OpeningHoursSpecification within the tooling has been accelerated in response to the COVID-19 pandemic. The proposal follows Google's documented usage, and so is unlikely to change significantly, however we welcome your contribution to the proposal with any thoughts and feedback from your implementation.
Standard opening hours
The standard opening hours of a
Place may be described using the openingHoursSpecification property as documented below. Note this property must not be used to define exceptional hours, such as specific public holidays, closures due to bad weather, or a pandemic-related lockdown.Open all year
Excluding the
validFrom and validThrough properties signifies that the hours are valid year-round. This example shows a business open every day from 6:30am until 21:30pm:1
"openingHoursSpecification": [
2
{
3
"@type": "OpeningHoursSpecification",
4
"dayOfWeek": [
5
"https://schema.org/Monday",
6
"https://schema.org/Tuesday",
7
"https://schema.org/Wednesday",
8
"https://schema.org/Thursday",
9
"https://schema.org/Friday",
10
"https://schema.org/Saturday",
11
"https://schema.org/Sunday"
12
],
13
"opens": "06:30",
14
"closes": "21:30"
15
}
16
]
Copied!
Public holidays
The
dayOfWeek value of https://schema.org/PublicHolidays is defined as a placeholder for all official public holidays in the location in which the Place is located. It can be used to indicate opening hours on public holidays, overriding general opening hours for the day of the week on which a public holiday occurs:1
"openingHoursSpecification": [
2
{
3
"@type": "OpeningHoursSpecification",
4
"dayOfWeek": [
5
"https://schema.org/Monday",
6
"https://schema.org/Tuesday",
7
"https://schema.org/Wednesday",
8
"https://schema.org/Thursday",
9
"https://schema.org/Friday"
10
],
11
"opens": "06:30",
12
"closes": "21:30"
13
},
14
{
15
"@type": "OpeningHoursSpecification",
16
"dayOfWeek": [
17
"https://schema.org/Saturday"
18
],
19
"opens": "07:15",
20
"closes": "17:30"
21
},
22
{
23
"@type": "OpeningHoursSpecification",
24
"dayOfWeek": [
25
"https://schema.org/Sunday",
26
"https://schema.org/PublicHolidays"
27
],
28
"opens": "09:00",
29
"closes": "17:30"
30
}
31
]
Copied!
Open seasonally
For Places that are open only seasonally (for example an Ice Rink), both the
validFrom and validThrough may be used. This example shows a business open only during weekends during the winter holidays:1
"openingHoursSpecification": [
2
{
3
"@type": "OpeningHoursSpecification",
4
"dayOfWeek": [
5
"https://schema.org/Saturday"
6
],
7
"opens": "09:30",
8
"closes": "20:30",
9
"validFrom": "2015-12-23",
10
"validThrough": "2016-01-05"
11
},
12
{
13
"@type": "OpeningHoursSpecification",
14
"dayOfWeek": [
15
"https://schema.org/Sunday"
16
],
17
"opens": "09:30",
18
"closes": "17:30",
19
"validFrom": "2015-12-23",
20
"validThrough": "2016-01-05"
21
}
22
]
Copied!
All-day open / closed
To show a business as open 24 hours a day, set the
open property to "00:00" and the closes property to "23:59".To show a business is closed all day, set both
opens and closes properties to "00:00".This example shows a business open all day Saturday and closed all day Sunday:
1
"openingHoursSpecification": [
2
{
3
"@type": "OpeningHoursSpecification",
4
"dayOfWeek": [
5
"https://schema.org/Saturday"
6
],
7
"opens": "00:00",
8
"closes": "23:59"
9
},
10
{
11
"@type": "OpeningHoursSpecification",
12
"dayOfWeek": [
13
"https://schema.org/Sunday"
14
],
15
"opens": "00:00",
16
"closes": "00:00"
17
}
18
]
Copied!
Late night hours
For hours past midnight, define opening and closing hours using a single
OpeningHoursSpecification property. This example defines hours from Saturday at 6pm until Sunday at 3am:1
"openingHoursSpecification": [
2
{
3
"@type": "OpeningHoursSpecification",
4
"dayOfWeek": [
5
"https://schema.org/Saturday"
6
],
7
"opens": "18:00",
8
"closes": "03:00"
9
}
10
]
Copied!
Multiple opening hours
For days with multiple hours, these must be provided as separate instances of
OpeningHoursSpecification.This example defines the following hours:
1
"openingHoursSpecification": [
2
{
3
"@type": "OpeningHoursSpecification",
4
"dayOfWeek": [
5
"https://schema.org/Monday",
6
"https://schema.org/Tuesday",
7
"https://schema.org/Wednesday",
8
"https://schema.org/Thursday"
9
],
10
"opens": "06:00",
11
"closes": "13:00"
12
},
13
{
14
"@type": "OpeningHoursSpecification",
15
"dayOfWeek": [
16
"https://schema.org/Monday",
17
"https://schema.org/Tuesday",
18
"https://schema.org/Wednesday",
19
"https://schema.org/Thursday"
20
],
21
"opens": "16:00",
22
"closes": "20:00"
23
},
24
{
25
"@type": "OpeningHoursSpecification",
26
"dayOfWeek": [
27
"https://schema.org/Friday"
28
],
29
"opens": "06:00",
30
"closes": "12:00"
31
},
32
{
33
"@type": "OpeningHoursSpecification",
34
"dayOfWeek": [
35
"https://schema.org/Saturday",
36
"https://schema.org/Sunday",
37
"https://schema.org/PublicHolidays"
38
],
39
"opens": "08:00",
40
"closes": "12:00"
41
}
42
]
Copied!
Special opening hours
The
specialOpeningHoursSpecification property of the Place is used to explicitly override standard opening hours brought in scope by openingHoursSpecification. Note this property must not be used to define standard hours, and should instead describe exceptions such as specific public holidays, closures due to bad weather, or a pandemic-related lockdown.Christmas and New Year
Use
specialOpeningHoursSpecification combined with validFrom and validThrough properties to specify opening hours for specific public holidays. This example shows a business closed on Christmas Day:1
"specialOpeningHoursSpecification": [
2
{
3
"@type": "OpeningHoursSpecification",
4
"opens": "00:00",
5
"closes": "00:00",
6
"validFrom": "2015-12-25",
7
"validThrough": "2015-12-25"
8
}
9
]
Copied!
COVID-19 Lockdown
Use
specialOpeningHoursSpecification combined with validFrom and validThrough properties to specify closure during specific dates. This example shows a business closed completely for all of January:1
"specialOpeningHoursSpecification": [
2
{
3
"@type": "OpeningHoursSpecification",
4
"opens": "00:00",
5
"closes": "00:00",
6
"validFrom": "2021-01-01",
7
"validThrough": "2021-01-31"
8
}
9
]
Copied!