Reference English
This page describes a data model for exposing structured information about job postings on the Web. The data model covers job posting, job seekers, work experience, compensation, locations and further auxiliary concepts. The data model is represented as an RDF vocabulary, and re-uses many terms from Schema.org.
Terms in the data model come from the following namespaces:
-
Schema.org: Many terms are taken from the Schema.org vocabulary. These terms are used without a prefix in this reference, e.g.,
ContactPoint. -
Dublin Core: A few terms are re-used from the Dublin Core Terms vocabulary and prefixed with
dcterms, e.g.,dcterms:valid. -
XML Schema Datatypes: Data types for literal value ranges are re-used from XML Schema and prefixed with
xsd, e.g.,xsd:integer.
Some vocabulary terms in the Schema.org namespace come from an extension proposal target to the job market. These terms include:
- Classes: Compensation, WorkExperience
- Properties: availableVacancies, compensation, contact, currency, duration, employer, isRemoteWork, references, startDate, type
URI: http://schema.org/Compensation
Compensation: Defines how the worker is paid for the work done
Superclass: QuantitativeValue
Properties: currency, maxValue, minValue, type, value
Example (RDFa):
<p rel="compensation">
Wage:
<span property="currency" content="EUR">€</span><span property="value">4.50</span>
(<span property="type">hourly</span> rate)
</p>Contact point: Information needed to respond to a job posting.
URI: http://schema.org/ContactPoint
Superclass: StructuredValue
Properties: email, name, telephone
Example (RDFa):
<div rel="contact">
<p property="name">John Doe</p>
<p>Phone: <span property="telephone" content="+35312345678">12 345678</span></p>
</div>Job posting: Description of a job offer.
URI: http://schema.org/JobPosting
Superclass: Intangible
Properties: address, availableVacancies, dcterms:modified, dcterms:publisher, dcterms:valid, description, employmentType, industry, isRemoteWork, responsibilities, startDate, title
Example (RDFa):
<body typeof="JobPosting">
<h1 property="title">Warehouse keeper</h1>
<!-- The <body> element contains further description of a job offer, using its properties. -->
</body>Organization: Collection of people organized together to form a business entity offering jobs.
URI: http://schema.org/Organization
Superclass: Thing
Properties: name
Example (RDFa):
<p rel="employer">
Employer: <span typeof="Organization"><span property="name">ACME Inc.</span></span>
</p>Person: Natural or legal person.
Superclass: Thing
Properties: name
Example (RDFa):
<p rel="employer">
Employer: <span typeof="Person"><span property="name">John Doe</span></span>
</p>Place: Space delimited location.
Superclass: Thing
Properties: address
Example (RDFa):
<div rel="jobLocation">
<p>Job location:</p>
<p rel="address">
<p property="streetAddress">Newcastle Rd. 126</p>
<p property="addressLocality">Galway</p>
</p>
</div>Postal address: Mailing address.
URI: http://schema.org/PostalAddress
Superclass: ContactPoint
Properties: addressLocality, streetAddress
Example (RDFa):
<p rel="address">
<p>Address:</p>
<p property="streetAddress">Newcastle Rd. 126</p>
<p property="addressLocality">Galway</p>
</p>Work experience: Job applicant's work history that demonstrates skills or competences.
URI: http://schema.org/WorkExperience
Superclass: StructuredValue
Properties: description, duration, references
Example (RDFa):
<h2>Required experience:</h2>
<ul>
<li rel="experienceRequirements"><span property="description">Forklift operation</span>, <span property="duration" content="P1Y">1 year</span></li>
<li rel="experienceRequirements"><span property="description">Industry experience</span>, <span property="duration" content="P2Y">2 years</span> (<span property="references" content="true">job applicant has to provide references</span>)</li>
</ul>These properties have a literal value, e.g., a string or number.
address locality: Locality referenced in a postal address, e.g., a city.
URI: http://schema.org/addressLocality
Compatible with (domain): PostalAddress
Allowed values (range): Text
Example (RDFa):
<span property="addressLocality">Galway</span>available vacancies: Number of persons sought for a job. Default value is 1.
URI: http://schema.org/availableVacancies
Compatible with (domain): JobPosting
Allowed values (range): xsd:integer
Example (RDFa):
<tr>
<th>Number of open vacancies:</th>
<td property="availableVacancies">5</td>
</tr>currency: Currency (in 3-letter ISO 4217 format), in which compensation is paid
URI: http://schema.org/currency
Compatible with (domain): Compensation
Allowed values (range): Text
Example (RDFa):
<span property="currency" content="EUR">€</span>modified: Date on which the resource was changed.
URI: http://purl.org/dc/terms/modified
Compatible with (domain): JobPosting
Allowed values (range): xsd:date
Example (RDFa):
<p>Last modified: <span property="dcterms:modified" content="2013-03-07">March 7, 2013</span></p>valid: Date (often a range) of validity of a resource.
URI: http://purl.org/dc/terms/valid
Compatible with (domain): JobPosting
Allowed values (range): xsd:date
Example (RDFa):
<p>The job posting is valid through <span property="dcterms:valid" content="2013-04-01">April 1, 2013</span>.</p>description: Textual description of a resource.
URI: http://schema.org/description
Compatible with (domain): WorkExperience, JobPosting
Allowed values (range): Text
Example (RDFa):
<div property="description">
<p>ACME Inc. is seeking a new employee for the job position of warehouse keeper. The job location is situated in Galway.</p>
<p>Apprenticeship and forklift certification required. Job applicants must have a clean criminal record.</p>
</div>duration: Length of period during which job applicant acquired experience
URI: http://schema.org/duration
Compatible with (domain): WorkExperience
Allowed values (range): xsd:duration (e.g., P2Y for two years, P6M for six months, P1Y2M for one year and two months)
Example (RDFa):
<p>Job applicant must have at least a <span property="duration" content="P1Y">year</span> of experience in the field.</p>email: Email address.
Compatible with (domain): ContactPoint
Allowed values (range): Text
Example (RDFa):
<p>Email: <a property="email" href="mailto:john.doe@acme.com">john.doe@acme.com</a></p>employment type: Type of employment (e.g. full-time, part-time, contract, temporary, seasonal, internship).
URI: http://schema.org/employmentType
Compatible with (domain): JobPosting
Allowed values (range): Controlled vocabulary
Example (RDFa):
<p><span property="employmentType">Full-time</span> job position.</p>industry: The industry associated with the job position. Includes also private employment.
URI: http://schema.org/industry
Compatible with (domain): JobPosting
Allowed values (range): Controlled vocabulary
Example (RDFa):
<p>Job industry: <span property="industry">production and manufacturing</span></p>is remote work: Indicates job postings for which location of execution does not matter (i.e. remote work)
URI: http://schema.org/isRemoteWork
Compatible with (domain): JobPosting
Allowed values (range): xsd:boolean
Example (RDFa):
<p property="isRemoteWork" content="true">Work from home.</p>maximum value: The highest value if the compensation is specified as a range.
URI: http://schema.org/maxValue
Compatible with (domain): Compensation
Allowed values (range): xsd:decimal
Example (RDFa):
<p>Monthly salary up to <span property="maxValue">1200</span> <span property="currency" content="EUR">€</span></p> minimum value: The lowest value if the compensation is specified as a range.
URI: http://schema.org/minValue
Compatible with (domain): Compensation
Allowed values (range): xsd:decimal
Example (RDFa):
<p>Applicant can expect a salary starting at <span property="minValue">1000</span> <span property="currency" content="EUR">€</span></p> name: Name of a resource.
Compatible with (domain): ContactPoint, Organization, Person
Allowed values (range): Text
Example (RDFa):
<p>Contact person: <span property="name">John Doe</span></p>references: Indicates whether applicant is able to provide contact for references
URI: http://schema.org/references
Compatible with (domain): WorkExperience
Allowed values (range): xsd:boolean
Example (RDFa):
<p>Previous work history need to be supported <span property="references" content="true">with references</span>.</p>responsibilities: Activities that the applicant is supposed to do as part of the job.
URI: http://schema.org/responsibilities
Compatible with (domain): JobPosting
Allowed values (range): Text
Example (RDFa):
<p>Applicant will be responsible for <span property="responsibilities">manipulation of warehoused goods with a forklift</span>.</p>start date: Date when employment starts.
URI: http://schema.org/startDate
Compatible with (domain): JobPosting
Allowed values (range): xsd:date or the special case "immediately"
Example (RDFa):
<p>Start date: <span property="startDate" content="2013-04-01">April 1, 2013</span></p>street address: Street name references in a postal address. May include a house number.
URI: http://schema.org/streetAddress
Compatible with (domain): PostalAddress
Allowed values (range): Text
Example (RDFa):
<p property="streetAddress">Newcastle Rd. 126</p>telephone: Phone number used in contact information.
URI: http://schema.org/telephone
Compatible with (domain): ContactPoint
Allowed values (range): Text
Example (RDFa):
<p>Phone: <span property="telephone" content="+35312345678">12 345678</span></p>title: Job title of the offered position.
Compatible with (domain): JobPosting
Allowed values (range): Text
Example (RDFa):
<p>Job title: <span property="title">warehouse keeper</span></p>type: Type of compensation. Recommended values are: annual, hourly, fixed.
URI: http://schema.org/type
Compatible with (domain): Compensation
Allowed values (range): Controlled vocabulary
Example (RDFa):
<span property="type">hourly</span> ratevalue: How much an employee will be paid for a job.
Compatible with (domain): Compensation
Allowed values (range): xsd:decimal
Example (RDFa):
<p>Wage: <span property="value">4.50</span> <span property="currency" content="EUR">€</span></p>These properties relate an instance of some class to another instance.
address: Property relating place to an associated postal address.
URI: http://schema.org/address
Compatible with (domain): JobPosting, Place
Allowed values (range): PostalAddress
Example (RDFa):
<p rel="address">
<p>Address:</p>
<p property="streetAddress">Newcastle Rd. 126</p>
<p property="addressLocality">Galway</p>
</p>compensation: Compensation paid by an employer to an employee.
URI: http://schema.org/compensation
Compatible with (domain): JobPosting
Allowed values (range): Compensation
Example (RDFa):
<p rel="compensation">
Wage:
<span property="value">4.50</span> <span property="currency" content="EUR">€</span>
(<span property="type">hourly</span> rate)
</p>contact: Contact information job seeker needs to respond to a job offer.
URI: http://schema.org/contact
Compatible with (domain): JobPosting
Allowed values (range): ContactPoint
Example (RDFa):
<div rel="contact">
<p property="name">John Doe</p>
<p>Phone: <span property="telephone" content="+35312345678">12 345678</span></p>
</div>publisher: Property relating job posting to an entity that posted it.
URI: http://purl.org/dc/terms/publisher
Compatible with (domain): JobPosting
Allowed values (range): Organization, Person
Example (RDFa):
<p>The job posting was originally published at <a rel="dcterms:publisher" href="http://damepraci.cz">Dáme práci</a>.</p>employer: Property relating job postings to persons or organizations offering a job.
URI: http://schema.org/employer
Compatible with (domain): JobPosting
Allowed values (range): Organization, Person
Example (RDFa):
<p>Employer: <a rel="employer" href="http://acme.com/">ACME Inc.</a></p>experience requirements: Description of skills and experience needed for the position.
URI: http://schema.org/experienceRequirements
Compatible with (domain): JobPosting
Allowed values (range): WorkExperience
Example (RDFa):
<div rel="experienceRequirements">
<p>Required experience:</p>
<p>At least a <span property="duration" content="P1Y">year</span> of <span property="description">work with forklift</span> (<span property="references" content="true">job applicant has to provide references</span>)</p>
</div>job location: A (typically single) geographic location associated with the job position.
URI: http://schema.org/jobLocation
Compatible with (domain): JobPosting
Allowed values (range): Place
Example (RDFa):
<div rel="jobLocation">
<p>Job location:</p>
<p rel="address">
<p property="streetAddress">Newcastle Rd. 126</p>
<p property="addressLocality">Galway</p>
</p>
</div>