Pub Schema

The Pub Schema organises pub identity, contact, location, opening hours, beer, food, drink and events into a consistent format, using Schema.org vocabulary where applicable.

2.1 Identity

Name	Type	Schema.org	Description
Identifier `pub.id`	text	@id	The permanent unique identifier already assigned to the pub. JSON-LD states the same value as @id. The identifier is not calculated from the name, telephone, or address.
Title `pub.title`	text	name	The name of the pub.
Description `pub.description`	text	description	A text description of the pub.

2.2 Incorporation details

Name	Type	Schema.org	Description
Company name `pub.company.name`	text	legalName	The registered company name, when the business is registered at Companies House and states that name. A missing value stays unknown. This is not the trading name. JSON-LD uses legalName.
Company number `pub.company.number`	text	additionalProperty	The company number, when the business is registered at Companies House and states that number. A missing value stays unknown. This is not a VAT number. When a number is stated, JSON-LD uses a PropertyValue named companyNumber.
Incorporation date `pub.company.incorporated_on`	date	foundingDate	The incorporation date, when the business is registered at Companies House and states that date. A missing date stays unknown. JSON-LD uses foundingDate for that stated date.
VAT number `pub.company.vat`	text	vatID	The VAT number, when the business is registered for VAT and states that number. A missing value stays unknown. This is not the company number. JSON-LD uses vatID.

2.3 Contact

Name	Type	Schema.org	Description
Phone `pub.contact.phone`	text	telephone	The telephone number of the pub.
Url `pub.contact.url`	url	url	The website address of the pub.
Email `pub.contact.email`	email	email	An email address for the pub, when one is stated. Leave it empty when none is known.

2.4 Location and coordinates

Name	Type	Schema.org	Description
Address `pub.location.address`	text	address	The postal address of the pub. The original address line stays intact.
Latitude `pub.location.latitude`	number	latitude	The WGS84 latitude of the pub.
Longitude `pub.location.longitude`	number	longitude	The WGS84 longitude of the pub. A coordinate pair is required before JSON-LD includes GeoCoordinates.
Postcode `pub.location.postcode`	text	postalCode	The UK postcode when one postcode is present in the postal address.
Street `pub.location.street`	text	streetAddress	The street line when the postal address separates it from the town. A borough is not the street.
Locality `pub.location.locality`	text	addressLocality	The town or city when the postal address states it as its own part. A borough is not the locality.
Region `pub.location.region`	text	addressRegion	The county or region when the postal address states it as its own part. A media-market code is not a region and is left empty.
Country `pub.location.country`	text	addressCountry	The country when the address states it. A two-letter country code is recorded as the country name. Leave it empty when the country is not stated.

2.5 Opening hours

Name	Type	Schema.org	Description
Opening hours `pub.hours.opening`	object	openingHoursSpecification	The regular opening hours when a weekly timetable states each open day and its opening and closing times. A current open or closed status is not opening hours. Busy periods are not opening hours. A day with no stated times is left empty.

2.6 Images

Name	Type	Schema.org	Description
Logo `pub.image.logo`	url	logo	The address of the pub logo, when one is stated. A missing address is omitted.
Main image `pub.image.main`	url	image	The address of the main image of the pub, when one is stated. A count of photographs is not an image. A missing address is omitted.

2.7 Reputation

Name	Type	Schema.org	Description
Review rating `pub.review.rating`	number	ratingValue	A review score from one provider. It is not a qualification or an award. A scale is recorded only when that provider states it. The score stays in the native record and is not copied into the core business JSON-LD.
Review count `pub.review.count`	integer	reviewCount	The number of reviews accompanying a review rating from the same provider. It is not calculated from another provider.
Rating count `pub.review.rating_count`	integer	ratingCount	The number of ratings when the provider states it separately from the number of reviews. It is not calculated from the distribution.
Rating distribution `pub.review.distribution`	object	—	Numbers recorded against scores 1 to 5. They are not the review count. Schema.org has no single property for the five counts, so this stays unmapped.
Rating scale `pub.review.scale`	object	—	The lowest and highest points of a review scale, when the scale is stated. Schema.org records those points as separate properties, so this attribute is not given one of them.
Review provider `pub.review.provider`	text	—	The organisation that published these figures. Figures from another provider are a separate observation and are not averaged together.
Observation date `pub.review.observed_on`	date	—	The date on which these figures were observed, when that date is stated.

2.8 Price

Name	Type	Schema.org	Description
Price range `pub.price_range`	text	priceRange	A price indication using £, ££, £££, or ££££. Leave it empty when none is stated. This is not a dish price.

2.9 Beer

Name	Type	Schema.org	Description
Beer offering `pub.beer.selection`	list	additionalProperty	The beers the pub states that it offers. The recorded values are Draught beer, Guinness, Cask ale, Local ales, Craft beer, and Brewed on site. Cider, wine, and cocktails are separate. A missing value stays unknown. When beers are stated, JSON-LD uses a PropertyValue named beerOffering.

2.10 Food, drink and events

Name	Type	Schema.org	Description
Sunday lunch `pub.service.sunday_lunch`	boolean	Service	Whether the pub serves Sunday lunch. A roast dinner on another day is a separate service. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Food served `pub.service.food`	boolean	Service	Whether the pub serves food, including home-cooked food, light bites, or a daily special. Named dishes are separate services. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Group bookings and events `pub.service.groups`	boolean	Service	Whether the pub takes group bookings or hosts an event, including a buffet. A wedding reception is separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Roast dinners `pub.service.roast`	boolean	Service	Whether the pub serves a roast dinner, including a carvery, Yorkshire pudding, or a spit roast. Sunday lunch is a separate service. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Fish and chips `pub.service.fish_and_chips`	boolean	Service	Whether the pub offers fish and chips, including chips, other seafood, a fish pie, or lobster. Pies are a separate service. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Desserts `pub.service.desserts`	boolean	Service	Whether the pub offers desserts, including sticky toffee pudding, cheesecake, or scones. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Steak `pub.service.steak`	boolean	Service	Whether the pub serves steak, including lamb or ribs. Burgers are separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Burgers `pub.service.burgers`	boolean	Service	Whether the pub serves burgers, including wings or fries. Steak is separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Vegetarian and vegan options `pub.service.vegetarian`	boolean	Service	Whether the pub offers vegetarian or vegan dishes. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Allergy and gluten-free catering `pub.service.allergy`	boolean	Service	Whether the pub can cater for a stated allergy, including gluten-free food. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Live music and entertainment `pub.service.music`	boolean	Service	Whether the pub has live music or other entertainment, including karaoke or an open mike night. A quiz is separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Breakfast `pub.service.breakfast`	boolean	Service	Whether the pub serves breakfast, including at the weekend. Sunday lunch is separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Quiz night `pub.service.quiz`	boolean	Service	Whether the pub holds a quiz night, including a music quiz or bingo. Live music is a separate service. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Wine `pub.service.wine`	boolean	Service	Whether the pub offers wine, including champagne or prosecco. Beer and cocktails are separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Pies `pub.service.pies`	boolean	Service	Whether the pub serves pies. Fish and chips are a separate service. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Pizza `pub.service.pizza`	boolean	Service	Whether the pub serves pizza. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Coffee and tea `pub.service.coffee`	boolean	Service	Whether the pub offers coffee or tea. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Takeaway food `pub.service.takeaway`	boolean	Service	Whether the pub offers takeaway food, including cans to take away. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Wedding receptions `pub.service.weddings`	boolean	Service	Whether the pub hosts wedding receptions. Other group bookings are separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Cider `pub.service.cider`	boolean	Service	Whether the pub offers cider. Beer and wine are separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Children's menu `pub.service.kids_menu`	boolean	Service	Whether the pub has a children's menu. A play area and high chairs are separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.
Cocktails and gin `pub.service.cocktails`	boolean	Service	Whether the pub offers cocktails or gin. Beer and wine are separate. JSON-LD includes a Service of this name in hasOfferCatalog only when the value is stated as offered. An explicit no and an unknown value add nothing.

2.11 Amenities

Name	Type	Schema.org	Description
Dog friendly `pub.amenity.dogs`	boolean	amenityFeature	Whether the pub welcomes dogs. A missing value is unknown, not absent.
Outdoor seating `pub.amenity.outdoor_seating`	boolean	amenityFeature	Whether the pub has outdoor seating. A beer garden is separate. A missing value is unknown, not absent.
Car park `pub.amenity.parking`	boolean	amenityFeature	Whether the pub has a car park, including free parking. A missing value is unknown, not absent.
Open fire or wood burner `pub.amenity.fire`	boolean	amenityFeature	Whether the pub has an open fire or a wood burner. A missing value is unknown, not absent.
Pub games `pub.amenity.games`	list	amenityFeature	The games the pub has. The recorded values are Pool table, Darts, Skittle alley, Bowls, Card games, and Bar games. A missing value stays unknown. When games are stated, JSON-LD uses an amenityFeature named Pub games.
Wheelchair access `pub.amenity.wheelchair_access`	boolean	amenityFeature	Whether the pub has wheelchair access. A missing value is unknown, not absent.
TV screens for sport `pub.amenity.sport`	boolean	amenityFeature	Whether the pub shows sport on television. A missing value is unknown, not absent.
Beer garden `pub.amenity.beer_garden`	boolean	amenityFeature	Whether the pub has a beer garden. Other outdoor seating is separate. A missing value is unknown, not absent.
Customer toilets `pub.amenity.toilets`	boolean	amenityFeature	Whether the pub has customer toilets. A missing value is unknown, not absent.
Children's play area `pub.amenity.play_area`	boolean	amenityFeature	Whether the pub has a children's play area, including soft play. A children's menu is separate. A missing value is unknown, not absent.
Wi-Fi `pub.amenity.wifi`	boolean	amenityFeature	Whether the pub offers Wi-Fi. A missing value is unknown, not absent.
High chairs `pub.amenity.high_chairs`	boolean	amenityFeature	Whether the pub has high chairs. A children's menu is separate. A missing value is unknown, not absent.

2.12 Pub details

Name	Type	Schema.org	Description
Accepts reservations `pub.details.reservations`	boolean	acceptsReservations	Whether the pub accepts reservations. Walk-in visits stay with this field. This is not a reservation record. A missing value stays unknown. JSON-LD uses acceptsReservations only when the value is stated as yes or no.
Children welcome `pub.details.children`	boolean	additionalProperty	Whether the pub welcomes children. A children's menu, high chairs, and a play area are separate. A missing value stays unknown. When a value is stated, JSON-LD uses a PropertyValue named childrenWelcome.
Rooms for overnight stay `pub.details.rooms`	boolean	additionalProperty	Whether the pub has rooms for an overnight stay. This is not a hotel listing. A missing value stays unknown. When a value is stated, JSON-LD uses a PropertyValue named overnightStays.
Alcohol-free and low-alcohol drinks `pub.details.alcohol_free`	boolean	additionalProperty	Whether the pub offers alcohol-free or low-alcohol drinks, including a soft drink. Beer, cider, wine, and cocktails are separate. A missing value stays unknown. When a value is stated, JSON-LD uses a PropertyValue named alcoholFreeDrinks.
Walkers and cyclists welcome `pub.details.walkers`	boolean	additionalProperty	Whether the pub welcomes walkers or cyclists, including drinking water or bike storage. A missing value stays unknown. When a value is stated, JSON-LD uses a PropertyValue named walkersWelcome.
Community owned pub `pub.details.community`	boolean	additionalProperty	Whether the pub is owned by the community. A missing value stays unknown. When a value is stated, JSON-LD uses a PropertyValue named communityOwned.