Home Recruiter Schema Attributes

Recruiter Schema

Recruiter Schema

The Recruiter Schema organises recruiter identity, contact, location, opening hours, recruitment, and client information into a consistent format, using Schema.org vocabulary where applicable.

2.1 Identity

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

2.2 Incorporation details

Name	Type	Schema.org	Description
Company name `recruiter.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 `recruiter.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 `recruiter.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 `recruiter.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 `recruiter.contact.phone`	text	telephone	The telephone number of the recruiter.
Url `recruiter.contact.url`	url	url	The website address of the recruiter.
Social profiles `recruiter.contact.social`	list	sameAs	Official profiles of the business on third-party social platforms. Excludes the business's own website (see contact.url) and booking or review listings. Each entry has a platform and the absolute https address of the business's own profile. The platform is facebook, instagram, x, linkedin, tiktok, youtube, threads, pinterest, or other. A platform is listed once, except other. The address must use that platform's site. A share or post address is omitted. An entry may also record source, date, confidence, and verification status. JSON-LD uses sameAs for each accepted address.
Booking and review listings `recruiter.contact.listings`	list	sameAs	Profiles of the business on booking and review platforms. Excludes the business's own website (see contact.url) and official social profiles (see contact.social). Each entry has a platform and the absolute https address of the business's own profile. The platform is tripadvisor, booking_com, google_business_profile, opentable, or other. A platform is listed once, except other. The address must use that platform's site. A share or post address is omitted. An entry may also record source, date, confidence, and verification status. JSON-LD uses sameAs for each accepted address.
Email `recruiter.contact.email`	email	email	An email address for the recruiter, when one is stated. Leave it empty when none is known.

2.4 Location and coordinates

Name	Type	Schema.org	Description
Address `recruiter.location.address`	text	address	The postal address of the recruiter. The original address line stays intact.
Latitude `recruiter.location.latitude`	number	latitude	The WGS84 latitude of the recruiter.
Longitude `recruiter.location.longitude`	number	longitude	The WGS84 longitude of the recruiter. A coordinate pair is required before JSON-LD includes GeoCoordinates.
Postcode `recruiter.location.postcode`	text	postalCode	The UK postcode when one postcode is present in the postal address.
Street `recruiter.location.street`	text	streetAddress	The street line when the postal address separates it from the town. A borough is not the street.
Locality `recruiter.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 `recruiter.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 `recruiter.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 `recruiter.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 `recruiter.image.logo`	url	logo	The address of the recruiter logo, when one is stated. A missing address is omitted.
Main image `recruiter.image.main`	url	image	The address of the main image of the recruiter, 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 `recruiter.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 `recruiter.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 `recruiter.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 `recruiter.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 `recruiter.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 `recruiter.review.provider`	text	—	The organisation that published these figures. Figures from another provider are a separate observation and are not averaged together.
Observation date `recruiter.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 level `recruiter.price_range`	text	priceRange	A price indication using £, ££, or £££. Leave it empty when none is stated. This is not a fee.

2.9 Recruitment

Name	Type	Schema.org	Description
Permanent recruitment `recruiter.service.permanent`	boolean	Service	Whether the recruiter fills permanent jobs. 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.
Job search and vacancy matching for candidates `recruiter.service.job_search`	boolean	Service	Whether the recruiter helps a candidate search for a job and match a vacancy. 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.
Temporary and agency staffing `recruiter.service.temporary`	boolean	Service	Whether the recruiter supplies temporary or agency staff. 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.
Candidate sourcing for employers `recruiter.service.sourcing`	boolean	Service	Whether the recruiter finds candidates for an employer. 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.
Interview preparation support `recruiter.service.interview`	boolean	Service	Whether the recruiter helps a candidate prepare for an interview. 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.
Post-placement follow-up `recruiter.service.follow_up`	boolean	Service	Whether the recruiter follows up after someone is placed in a job. 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.
CV support `recruiter.service.cv`	boolean	Service	Whether the recruiter helps with a CV. 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.
Healthcare staffing `recruiter.service.healthcare`	boolean	Service	Whether the recruiter supplies healthcare staff, including locum and home-care staff. 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.
Training provision `recruiter.service.training`	boolean	Service	Whether the recruiter provides training, including mandatory training. 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.
Education sector staffing `recruiter.service.education`	boolean	Service	Whether the recruiter supplies education staff, including a nursery and invigilation. 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.
Warehouse and industrial staffing `recruiter.service.warehouse`	boolean	Service	Whether the recruiter supplies warehouse or industrial staff. 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.
IT recruitment `recruiter.service.it`	boolean	Service	Whether the recruiter recruits for IT roles. 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.
Fire and security recruitment `recruiter.service.security`	boolean	Service	Whether the recruiter recruits for fire and security roles. 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.
Veterinary recruitment `recruiter.service.veterinary`	boolean	Service	Whether the recruiter recruits for veterinary roles. 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.10 Recruiter details

Name	Type	Schema.org	Description
Sector specialisms `recruiter.details.sectors`	list	knowsAbout	The sectors the recruiter states that it covers. The recorded values are Healthcare, Education, IT, Warehouse and logistics, Industrial and manufacturing, Fire and security, Veterinary, Finance, Engineering, Construction, Hospitality, Office and admin, Agriculture, and Legal. An empty list is omitted. JSON-LD uses knowsAbout.
Online shift booking via app `recruiter.details.shifts`	boolean	additionalProperty	Whether the recruiter lets someone book a shift in an app. A missing value stays unknown. This is not a booking record. When a value is stated, JSON-LD uses a PropertyValue named onlineShiftBooking.
Daily pay `recruiter.details.daily_pay`	boolean	additionalProperty	Whether the recruiter pays daily. A missing value stays unknown. This is not the price level. When a value is stated, JSON-LD uses a PropertyValue named dailyPay.
Out-of-hours support `recruiter.details.out_of_hours`	boolean	additionalProperty	Whether the recruiter offers support outside ordinary opening hours. A missing value stays unknown. When a value is stated, JSON-LD uses a PropertyValue named outOfHoursSupport.