{
    "id": "https://schema.org.uk/schemas/recruiter/1.0",
    "version": "1.0",
    "name": "Recruiter Schema",
    "description": "The Recruiter Schema organises recruiter identity, contact, location, opening hours, recruitment, and client information into a consistent format, using Schema.org vocabulary where applicable.",
    "sections": [
        {
            "name": "Identity",
            "key": "identity",
            "attributes": [
                {
                    "name": "recruiter.id",
                    "label": "Identifier",
                    "description": "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.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": true,
                    "schema_org": "@id"
                },
                {
                    "name": "recruiter.title",
                    "label": "Title",
                    "description": "The name of the recruiter.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": true,
                    "schema_org": "name"
                },
                {
                    "name": "recruiter.description",
                    "label": "Description",
                    "description": "A text description of the recruiter.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "description"
                }
            ]
        },
        {
            "name": "Incorporation details",
            "key": "company",
            "attributes": [
                {
                    "name": "recruiter.company.name",
                    "label": "Company name",
                    "description": "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.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "legalName",
                    "component": "https://schema.org.uk/schemas/components/company"
                },
                {
                    "name": "recruiter.company.number",
                    "label": "Company number",
                    "description": "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.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "additionalProperty",
                    "component": "https://schema.org.uk/schemas/components/company"
                },
                {
                    "name": "recruiter.company.incorporated_on",
                    "label": "Incorporation date",
                    "description": "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.",
                    "data_type": "date",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "foundingDate",
                    "component": "https://schema.org.uk/schemas/components/company"
                },
                {
                    "name": "recruiter.company.vat",
                    "label": "VAT number",
                    "description": "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.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "vatID",
                    "component": "https://schema.org.uk/schemas/components/company"
                }
            ]
        },
        {
            "name": "Contact",
            "key": "contact",
            "attributes": [
                {
                    "name": "recruiter.contact.phone",
                    "label": "Phone",
                    "description": "The telephone number of the recruiter.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "telephone",
                    "component": "https://schema.org.uk/schemas/components/contact"
                },
                {
                    "name": "recruiter.contact.url",
                    "label": "Url",
                    "description": "The website address of the recruiter.",
                    "data_type": "url",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "url",
                    "component": "https://schema.org.uk/schemas/components/contact"
                },
                {
                    "name": "recruiter.contact.social",
                    "label": "Social profiles",
                    "description": "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.",
                    "data_type": "list",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "sameAs",
                    "component": "https://schema.org.uk/schemas/components/contact",
                    "entry": {
                        "data_type": "object",
                        "fields": [
                            {
                                "name": "platform",
                                "data_type": "text",
                                "values": [
                                    "facebook",
                                    "instagram",
                                    "x",
                                    "linkedin",
                                    "tiktok",
                                    "youtube",
                                    "threads",
                                    "pinterest",
                                    "other"
                                ]
                            },
                            {
                                "name": "url",
                                "data_type": "url"
                            },
                            {
                                "name": "source",
                                "data_type": "text"
                            },
                            {
                                "name": "date",
                                "data_type": "date"
                            },
                            {
                                "name": "confidence",
                                "data_type": "text",
                                "values": [
                                    "high",
                                    "medium",
                                    "low"
                                ]
                            },
                            {
                                "name": "verification_status",
                                "data_type": "text",
                                "values": [
                                    "stated",
                                    "verified",
                                    "unknown"
                                ]
                            }
                        ]
                    }
                },
                {
                    "name": "recruiter.contact.listings",
                    "label": "Booking and review listings",
                    "description": "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.",
                    "data_type": "list",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "sameAs",
                    "component": "https://schema.org.uk/schemas/components/contact",
                    "entry": {
                        "data_type": "object",
                        "fields": [
                            {
                                "name": "platform",
                                "data_type": "text",
                                "values": [
                                    "tripadvisor",
                                    "booking_com",
                                    "google_business_profile",
                                    "opentable",
                                    "other"
                                ]
                            },
                            {
                                "name": "url",
                                "data_type": "url"
                            },
                            {
                                "name": "source",
                                "data_type": "text"
                            },
                            {
                                "name": "date",
                                "data_type": "date"
                            },
                            {
                                "name": "confidence",
                                "data_type": "text",
                                "values": [
                                    "high",
                                    "medium",
                                    "low"
                                ]
                            },
                            {
                                "name": "verification_status",
                                "data_type": "text",
                                "values": [
                                    "stated",
                                    "verified",
                                    "unknown"
                                ]
                            }
                        ]
                    }
                },
                {
                    "name": "recruiter.contact.email",
                    "label": "Email",
                    "description": "An email address for the recruiter, when one is stated. Leave it empty when none is known.",
                    "data_type": "email",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "email",
                    "component": "https://schema.org.uk/schemas/components/contact"
                }
            ]
        },
        {
            "name": "Location and coordinates",
            "key": "location_and_coordinates",
            "attributes": [
                {
                    "name": "recruiter.location.address",
                    "label": "Address",
                    "description": "The postal address of the recruiter. The original address line stays intact.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "address"
                },
                {
                    "name": "recruiter.location.latitude",
                    "label": "Latitude",
                    "description": "The WGS84 latitude of the recruiter.",
                    "data_type": "number",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "latitude"
                },
                {
                    "name": "recruiter.location.longitude",
                    "label": "Longitude",
                    "description": "The WGS84 longitude of the recruiter. A coordinate pair is required before JSON-LD includes GeoCoordinates.",
                    "data_type": "number",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "longitude"
                },
                {
                    "name": "recruiter.location.postcode",
                    "label": "Postcode",
                    "description": "The UK postcode when one postcode is present in the postal address.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "postalCode",
                    "component": "https://schema.org.uk/schemas/components/address"
                },
                {
                    "name": "recruiter.location.street",
                    "label": "Street",
                    "description": "The street line when the postal address separates it from the town. A borough is not the street.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "streetAddress",
                    "component": "https://schema.org.uk/schemas/components/address"
                },
                {
                    "name": "recruiter.location.locality",
                    "label": "Locality",
                    "description": "The town or city when the postal address states it as its own part. A borough is not the locality.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "addressLocality",
                    "component": "https://schema.org.uk/schemas/components/address"
                },
                {
                    "name": "recruiter.location.region",
                    "label": "Region",
                    "description": "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.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "addressRegion",
                    "component": "https://schema.org.uk/schemas/components/address"
                },
                {
                    "name": "recruiter.location.country",
                    "label": "Country",
                    "description": "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.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "addressCountry",
                    "component": "https://schema.org.uk/schemas/components/address"
                }
            ]
        },
        {
            "name": "Opening hours",
            "key": "opening_hours",
            "attributes": [
                {
                    "name": "recruiter.hours.opening",
                    "label": "Opening hours",
                    "description": "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.",
                    "data_type": "object",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "openingHoursSpecification"
                }
            ]
        },
        {
            "name": "Images",
            "key": "images",
            "attributes": [
                {
                    "name": "recruiter.image.logo",
                    "label": "Logo",
                    "description": "The address of the recruiter logo, when one is stated. A missing address is omitted.",
                    "data_type": "url",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "logo"
                },
                {
                    "name": "recruiter.image.main",
                    "label": "Main image",
                    "description": "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.",
                    "data_type": "url",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "image",
                    "component": "https://schema.org.uk/schemas/components/image"
                }
            ]
        },
        {
            "name": "Reputation",
            "key": "review_statistics",
            "attributes": [
                {
                    "name": "recruiter.review.rating",
                    "label": "Review rating",
                    "description": "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.",
                    "data_type": "number",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "ratingValue",
                    "component": "https://schema.org.uk/schemas/components/reputation"
                },
                {
                    "name": "recruiter.review.count",
                    "label": "Review count",
                    "description": "The number of reviews accompanying a review rating from the same provider. It is not calculated from another provider.",
                    "data_type": "integer",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "reviewCount",
                    "component": "https://schema.org.uk/schemas/components/reputation"
                },
                {
                    "name": "recruiter.review.rating_count",
                    "label": "Rating count",
                    "description": "The number of ratings when the provider states it separately from the number of reviews. It is not calculated from the distribution.",
                    "data_type": "integer",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "ratingCount",
                    "component": "https://schema.org.uk/schemas/components/reputation"
                },
                {
                    "name": "recruiter.review.distribution",
                    "label": "Rating distribution",
                    "description": "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.",
                    "data_type": "object",
                    "scope": "recruiter",
                    "required": false,
                    "component": "https://schema.org.uk/schemas/components/reputation"
                },
                {
                    "name": "recruiter.review.scale",
                    "label": "Rating scale",
                    "description": "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.",
                    "data_type": "object",
                    "scope": "recruiter",
                    "required": false,
                    "component": "https://schema.org.uk/schemas/components/reputation"
                },
                {
                    "name": "recruiter.review.provider",
                    "label": "Review provider",
                    "description": "The organisation that published these figures. Figures from another provider are a separate observation and are not averaged together.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "component": "https://schema.org.uk/schemas/components/reputation"
                },
                {
                    "name": "recruiter.review.observed_on",
                    "label": "Observation date",
                    "description": "The date on which these figures were observed, when that date is stated.",
                    "data_type": "date",
                    "scope": "recruiter",
                    "required": false,
                    "component": "https://schema.org.uk/schemas/components/reputation"
                }
            ]
        },
        {
            "name": "Price",
            "key": "price",
            "attributes": [
                {
                    "name": "recruiter.price_range",
                    "label": "Price level",
                    "description": "A price indication using £, ££, or £££. Leave it empty when none is stated. This is not a fee.",
                    "data_type": "text",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "priceRange"
                }
            ]
        },
        {
            "name": "Recruitment",
            "key": "services",
            "attributes": [
                {
                    "name": "recruiter.service.permanent",
                    "label": "Permanent recruitment",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.job_search",
                    "label": "Job search and vacancy matching for candidates",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.temporary",
                    "label": "Temporary and agency staffing",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.sourcing",
                    "label": "Candidate sourcing for employers",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.interview",
                    "label": "Interview preparation support",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.follow_up",
                    "label": "Post-placement follow-up",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.cv",
                    "label": "CV support",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.healthcare",
                    "label": "Healthcare staffing",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.training",
                    "label": "Training provision",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.education",
                    "label": "Education sector staffing",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.warehouse",
                    "label": "Warehouse and industrial staffing",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.it",
                    "label": "IT recruitment",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.security",
                    "label": "Fire and security recruitment",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                },
                {
                    "name": "recruiter.service.veterinary",
                    "label": "Veterinary recruitment",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "Service"
                }
            ]
        },
        {
            "name": "Recruiter details",
            "key": "details",
            "attributes": [
                {
                    "name": "recruiter.details.sectors",
                    "label": "Sector specialisms",
                    "description": "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.",
                    "data_type": "list",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "knowsAbout"
                },
                {
                    "name": "recruiter.details.shifts",
                    "label": "Online shift booking via app",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "additionalProperty"
                },
                {
                    "name": "recruiter.details.daily_pay",
                    "label": "Daily pay",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "additionalProperty"
                },
                {
                    "name": "recruiter.details.out_of_hours",
                    "label": "Out-of-hours support",
                    "description": "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.",
                    "data_type": "boolean",
                    "scope": "recruiter",
                    "required": false,
                    "schema_org": "additionalProperty"
                }
            ]
        }
    ],
    "components": [
        {
            "id": "https://schema.org.uk/schemas/components/address",
            "name": "Address",
            "description": "A postal address other category schemas can reuse. The original address line stays intact. Missing parts are left empty.",
            "fields": [
                "address",
                "postcode",
                "street",
                "locality",
                "region",
                "country"
            ]
        },
        {
            "id": "https://schema.org.uk/schemas/components/contact",
            "name": "Contact",
            "description": "Telephone, website, social profiles, booking and review listings, and email other category schemas can reuse. Each value is optional. A missing value stays empty.",
            "fields": [
                "phone",
                "url",
                "social",
                "listings",
                "email"
            ]
        },
        {
            "id": "https://schema.org.uk/schemas/components/company",
            "name": "Incorporation details",
            "description": "Registered company name, company number, and incorporation date when a business is registered at Companies House, and a VAT number when it is registered for VAT. Each value is included only when it is stated. A missing value stays unknown. Other category schemas reuse these fields.",
            "fields": [
                "name",
                "number",
                "incorporated_on",
                "vat"
            ]
        },
        {
            "id": "https://schema.org.uk/schemas/components/image",
            "name": "Image",
            "description": "An image, or one image in an ordered collection. Caption, attribution, and a rights note are optional. A missing note stays empty.",
            "fields": [
                "position",
                "url",
                "caption",
                "attribution",
                "rights"
            ]
        },
        {
            "id": "https://schema.org.uk/schemas/components/reputation",
            "name": "Reputation",
            "description": "Optional figures from one rating provider. A rating, a rating count, a review count, a scale, a distribution, and the date of the observation are recorded only when that provider states them. Themes are included only when a category records them. Figures from different providers are not combined. These figures are not copied into the core business JSON-LD.",
            "fields": [
                "provider",
                "rating",
                "rating_count",
                "count",
                "scale",
                "distribution",
                "observed_on",
                "themes"
            ]
        },
        {
            "id": "https://schema.org.uk/schemas/components/review-statistics",
            "name": "Review statistics",
            "alias_of": "https://schema.org.uk/schemas/components/reputation",
            "description": "Previous name of the Reputation component. New definitions use the Reputation component.",
            "fields": [
                "provider",
                "rating",
                "rating_count",
                "count",
                "scale",
                "distribution",
                "observed_on",
                "themes"
            ]
        },
        {
            "id": "https://schema.org.uk/schemas/components/offers",
            "name": "Offers",
            "optional": true,
            "description": "A contract for a later priced offer. It is not part of a core business schema. A service, a treatment, or a free or paid facility is not an offer by itself. The contract can record the item offered, the seller, the price and its currency, availability, the start and end dates, and the conditions. Live prices and bookings are not included.",
            "fields": [
                "item",
                "seller",
                "price",
                "currency",
                "availability",
                "valid_from",
                "valid_through",
                "conditions"
            ]
        }
    ]
}