Create a gist now

Instantly share code, notes, and snippets.

What would you like to do?
Job Posting Standard

An open standard for job postings

Read - Setting an open standard for job postings

All job postings should be published as structured data, including the information set out in the recommended minimum standard.

The standard uses and extends schema.org/JobPosting; adding properties based on user needs.

This gist uses JSON-LD as an example format to add information to your web content. You could also use Microdata or RDFa formats.

Recommended minimum standard

Property Expected type Description
Properties from JobPosting
schema:dateClosing (extension currently unsupported) schema:Date The date the job posting closes.
schema:datePosted schema:Date Publication date for the job posting.
schema:employmentType schema:Text Type of employment (e.g. permanent, temporary, contract, seasonal, internship / employed, self-employed).
schema:hiringOrganization schema:Organization The end employer offering the job position.
schema:jobLocation schema:Place A (ideally single) geographic location associated with the job position.
schema:minSalary (extension currently unsupported) schema:Number The minimum salary of the job.
schema:responsibilities schema:Text Responsibilities and day-to-day tasks associated with this role.
schema:skills schema:Text Skills and personal qualities required to fulfill this role.
schema:title schema:Text The title of the job.
schema:workHours schema:Text The typical working hours for this job including pattern (e.g. 1st shift, night shift, 8am-5pm).
Properties from Organization
schema:name schema:Text The name of the item.
schema:contactPoint schema:ContactPoint A contact point for a person or organisation.
schema:email schema:Text Email address.
schema:telephone schema:Text The telephone number.
schema:url schema:URL URL of the item.
Properties from PostalAddress
schema:streetAddress schema:Text The street address. For example, 1 Oxford Place.
schema:addressLocality schema:Text The locality. For example, Leeds.
schema:addressRegion schema:Text The region. For example, West Yorkshire.
schema:postalCode schema:Text The postcode. For example, LS1 1XX.
schema:addressCountry schema:Text The country. For example, UK.

Additional properties found in the JSON example are desirable, but not essential.

{
"@context": "http://schema.org",
"@type": "JobPosting",
"dateClosing": "2011-11-30",
"datePosted": "2011-10-31",
"description": "ABC Limited Company, seeks a full-time mid-level software engineer to develop in-house tools.",
"educationRequirements": "Masters in Computer Science, Information Systems or related fields of study.",
"employmentType": "Permanent, Employed",
"experienceRequirements": "Minumum 3 years experience as a software engineer.",
"hiringOrganization": {
"@type": "Organization",
"name": "ABC Limited Company",
"contactPoint": "Jane Smith",
"email": "email@your-site.com",
"telephone": "+44 113 123 456",
"url": "http://www.your-site.com"
},
"incentiveCompensation": "Performance-based annual bonus plan, project-completion bonuses",
"industry": "Computer Software",
"jobBenefits": "Bupa, Pension, Gym membership",
"jobLocation": {
"@type": "Place",
"address": {
"@type": "PostalAddress",
"streetAddress": "1 Oxford Place",
"addressLocality": "Leeds",
"addressRegion": "West Yorkshire",
"postalCode": "LS1 1XX",
"addressCountry": "UK"
}
},
"minSalary": "80,000",
"maxSalary": "100,000",
"occupationalCategory": "15-1132.00 Software Developers, Application",
"qualifications": "Web application development using Java/J2EE. Web application development using Python or familiarity with dynamic programming languages.",
"reference": "ABC123XXX",
"responsibilities": "Design and write specifications for tools for in-house customers. Build tools according to specifications.",
"skills": "Ability to work in a team environment with members of varying skill levels. Highly motivated. Learns quickly.",
"title": "Software Developer",
"workHours": "40 hours per week"
}

JobPosting is in the process of being considered as a recommended (rather than compulsory) standard for government by the Open Standards Board. The proposal is published on the standards hub. It's acknowledged in the original proposal that guidance in the application of the schema is required and should be a continuing project , this appears to be inline with the work here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment