--- title: "JobPosting Schema - JSON-LD Guide & Examples · Unhead" meta: "og:description": "Implement JobPosting structured data with Unhead. JSON-LD examples, required fields for Google Jobs, salary markup, and validation tips." "og:title": "JobPosting Schema - JSON-LD Guide & Examples · Unhead" description: "Implement JobPosting structured data with Unhead. JSON-LD examples, required fields for Google Jobs, salary markup, and validation tips." --- **Schema** # **JobPosting Schema - JSON-LD Guide & Examples** [Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/job-posting.md) Last updated **Mar 5, 2026** by [Harlan Wilton](https://github.com/harlan-zw) in [docs: improve SEO for schema.org pages, overview, and React Helmet migration (#675)](https://github.com/unjs/unhead/pull/675). **On this page ** - [JSON-LD Example](#json-ld-example) - [Schema.org Job Posting](#schemaorg-job-posting) - [Useful Links](#useful-links) - [Required properties](#required-properties) - [Recommended Properties](#recommended-properties) - [Defaults](#defaults) - [Resolves](#resolves) - [Examples](#examples) - [Types](#types) - [Related Schemas](#related-schemas) JobPosting schema enables your job listings to appear in Google Jobs search results with salary, location, and application details. It's required for Google Jobs integration. ### [JSON-LD Example](#json-ld-example) ``` { "@context": "https://schema.org", "@type": "JobPosting", "title": "Software Engineer", "description": "We are looking for a Software Engineer to join our team.", "datePosted": "2026-01-15", "validThrough": "2026-04-15", "employmentType": "FULL_TIME", "hiringOrganization": { "@type": "Organization", "name": "Acme Corp", "sameAs": "https://acme.com" }, "jobLocation": { "@type": "Place", "address": { "@type": "PostalAddress", "addressLocality": "San Francisco", "addressRegion": "CA", "addressCountry": "US" } }, "baseSalary": { "@type": "MonetaryAmount", "currency": "USD", "value": { "@type": "QuantitativeValue", "value": 120000, "unitText": "YEAR" } } } ``` With Unhead, generate this using the `defineJobPosting()` composable — see the [**API reference**](#schema-org-job-posting) below. Use the [**Schema.org Generator**](https://unhead.unjs.io/tools/schema-generator) to build your structured data visually. ## [Schema.org Job Posting](#schemaorg-job-posting) - **Type**: `defineJobPosting(input: JobPosting)`Describes a `JobPosting` on a `WebPage`. ## [Useful Links](#useful-links) - [**JobPosting - Schema.org**](https://schema.org/JobPosting) - [**JobPosting Schema Markup - Google Search Central**](https://developers.google.com/search/docs/appearance/structured-data/job-posting) ## [Required properties](#required-properties) - **title** `string`The title of the job (not the title of the posting). For example, "Software Engineer" or "Barista" - **description** `string`The full description of the job in HTML format. - **hiringOrganization** [**Organization**](https://unhead.unjs.io/docs/schema-org/api/schema/organization)The organization offering the job position. - **jobLocation** `Place`The location(s) where the job is available. - **datePosted** `ResolvableDate`Publication date for the job posting. ## [Recommended Properties](#recommended-properties) - **employmentType** `string`Type of employment (e.g. full-time, part-time, contract, temporary, seasonal, internship). - **validThrough** `ResolvableDate`The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours. - **applicantLocationRequirements** - `AdministrativeArea`The region(s) of the organization where the job is available. - **baseSalary** - `MonetaryAmount`The base salary of the job or of an employee in an EmployeeRole. - **directApply** - `boolean`Indicates whether direct application is allowed. - **identifier** - `string`An identifier for the job posting, unique within the hiring organization. - **jobLocationType** - `string`A description of the job location (e.g TELECOMMUTE for telecommute jobs). ## [Defaults](#defaults) - **@type**: `JobPosting` - **@id**: `${canonicalUrl}#job-posting` - **hiringOrganization**: id reference of the identity - **mainEntityOfPage** id reference of the web page ## [Resolves](#resolves) See [**Global Resolves**](https://unhead.unjs.io/docs/schema-org/guides/get-started/overview#site-page-level-config) for full context. - `datePosted` - Date - `hiringOrganization` - Organization - `jobLocation` - Place - `baseSalary` - MonetaryAmount - `validThrough` - Date ## [Examples](#examples) ### [Simple](#simple) ``` defineJobPosting({ title: 'Software Engineer', description: 'We are looking for a Software Engineer to join our team to help us build Unhead.', hiringOrganization: { name: 'Unhead', }, jobLocation: { address: { streetAddress: '1600 Amphitheatre Pkwy', addressLocality: 'Mountain View', addressRegion: 'CA', postalCode: '94043', addressCountry: 'US', } }, baseSalary: { currency: 'USD', value: { value: 100000, unitText: 'YEAR', }, }, employmentType: 'FULL_TIME', validThrough: '2022-02-01', datePosted: '2022-01-01', }) ``` ## [Types](#types) ``` /** * A listing that describes a job opening in a certain organization. */ export interface JobPostingSimple extends Thing { /** * The original date that employer posted the job in ISO 8601 format. * For example, "2017-01-24" or "2017-01-24T19:33:17+00:00". */ datePosted: ResolvableDate /** * The full description of the job in HTML format. * * The description must be a complete representation of the job, including job responsibilities, qualifications, * skills, working hours, education requirements, and experience requirements. The description can't be the same as * the title */ description: string /** * The organization offering the job position. This must be the name of the company (for example, "Starbucks, Inc"), * and not the specific location that is hiring (for example, "Starbucks on Main Street"). */ hiringOrganization: NodeRelation /** * The physical location(s) of the business where the employee will report to work (such as an office or worksite), * not the location where the job was posted. Include as many properties as possible. The more properties you provide, * the higher quality the job posting is to our users. Note that you must include the addressCountry property. */ jobLocation: NodeRelation /** * The title of the job (not the title of the posting). For example, "Software Engineer" or "Barista" */ title: string /** * The actual base salary for the job, as provided by the employer (not an estimate). */ baseSalary?: MonetaryAmount /** * Type of employment */ employmentType?: EmploymentType | EmploymentType[] /** * The date when the job posting will expire in ISO 8601 format. For example, "2017-02-24" * or "2017-02-24T19:33:17+00:00". */ validThrough?: ResolvableDate /** * A description of the job location (e.g. TELECOMMUTE for telecommute jobs). */ jobLocationType?: 'TELECOMMUTE' /** * Indicates whether the URL that's associated with this job posting enables direct application for the job. */ directApply?: boolean } ``` ## [Related Schemas](#related-schemas) - [**Organization**](https://unhead.unjs.io/docs/schema-org/api/schema/organization) - Hiring organization - [**LocalBusiness**](https://unhead.unjs.io/docs/schema-org/api/schema/local-business) - Job location [Edit this page](https://github.com/unjs/unhead/edit/main/docs/schema-org/5.api/9.schema/job-posting.md) [Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/job-posting.md) **Did this page help you? ** [**ItemList** Add ItemList structured data with Unhead. JSON-LD examples for carousels, ranked lists, and product collections with Google rich result support.](https://unhead.unjs.io/docs/schema-org/api/schema/item-list) [**LocalBusiness** Implement LocalBusiness structured data with Unhead. JSON-LD examples, required properties, subtypes (Dentist, Restaurant, Store), and Google rich result setup.](https://unhead.unjs.io/docs/schema-org/api/schema/local-business) **On this page ** - [JSON-LD Example](#json-ld-example) - [Schema.org Job Posting](#schemaorg-job-posting) - [Useful Links](#useful-links) - [Required properties](#required-properties) - [Recommended Properties](#recommended-properties) - [Defaults](#defaults) - [Resolves](#resolves) - [Examples](#examples) - [Types](#types) - [Related Schemas](#related-schemas)