Occupation - Schema.org Type
Note
: You are viewing the development
version of
Schema.org
See
how we work
for more details.
Schema.org
Docs
Schemas
Validate
About
Occupation
A Schema.org Type
Thing
Intangible
Occupation
[more...]
Canonical URL: https://schema.org/Occupation
Check for open issues.
A profession, may involve prolonged training and/or a formal qualification.
Property
Expected Type
Description
Properties from
Occupation
educationRequirements
EducationalOccupationalCredential
or
Text
Educational background needed for the position or Occupation.
estimatedSalary
MonetaryAmount
or
MonetaryAmountDistribution
or
Number
An estimated salary for a job posting or occupation, based on a variety of variables including, but not limited to industry, job title, and location. Estimated salaries are often computed by outside organizations rather than the hiring organization, who may not have committed to the estimated value.
experienceRequirements
OccupationalExperienceRequirements
or
Text
Description of skills and experience needed for the position or Occupation.
occupationLocation
AdministrativeArea
The region/country for which this occupational description is appropriate. Note that educational requirements and qualifications can vary between jurisdictions.
occupationalCategory
CategoryCode
or
Text
A category describing the job, preferably using a term from a taxonomy such as
BLS O*NET-SOC
ISCO-08
or similar, with the property repeated for each applicable value. Ideally the taxonomy should be identified, and both the textual label and formal code for the category should be provided.
Note: for historical reasons, any textual label and formal code provided as a literal may be assumed to be from O*NET-SOC.
qualifications
Credential
or
Text
Specific qualifications required for this role or Occupation.
responsibilities
Text
Responsibilities associated with this role or Occupation.
skills
DefinedTerm
or
Text
A statement of knowledge, skill, ability, task or any other assertion expressing a competency that is either claimed by a person, an organization or desired or required to fulfill a role or to work in an occupation.
Properties from
Thing
additionalType
Text
or
URL
An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. Typically the value is a URI-identified RDF class, and in this case corresponds to the
use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org
style guide
alternateName
Text
An alias for the item.
description
Text
or
TextObject
A description of the item.
disambiguatingDescription
Text
A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
identifier
PropertyValue
or
Text
or
URL
The identifier property represents any kind of identifier for any kind of
Thing
, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See
background notes
for more details.
image
ImageObject
or
URL
An image of the item. This can be a
URL
or a fully described
ImageObject
mainEntityOfPage
CreativeWork
or
URL
Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See
background notes
for details.
Inverse property:
mainEntity
name
Text
The name of the item.
owner
Organization
or
Person
A person or organization who owns this Thing.
Inverse property:
owns
potentialAction
Action
Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
sameAs
URL
URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.
subjectOf
CreativeWork
or
Event
A CreativeWork or Event about this Thing.
Inverse property:
about
url
URL
URL of the item.
Instances of
Occupation
may appear as a value for the following properties
Property
On Types
Description
hasOccupation
Person
The Person's occupation. For past professions, use Role for expressing dates.
relevantOccupation
JobPosting
The Occupation for the JobPosting.
Source
Examples
Example 1
Copied
No Markup
JSON-LD
Structure
Example notes or example HTML without markup.
See JSON example.
Example encoded as
JSON-LD
in a HTML script tag.

Structured representation of the JSON-LD example.
"@context": "https://schema.org/",
"@type": "Person",
"name": "Peter Venkman",
"hasOccupation": {
"@type": "Occupation",
"name": "Parapsychologist",
"educationRequirements": "PhD in parapsychology"
Example 2
Copied
No Markup
JSON-LD
Structure
Example notes or example HTML without markup.
See JSON example.
Example encoded as
JSON-LD
in a HTML script tag.

Structured representation of the JSON-LD example.
"@context": "https://schema.org/",
"@type": "Person",
"name": "Albert Einstein",
"hasOccupation": [
"@type": "Role",
"hasOccupation": {
"@type": "Occupation",
"name": "Patent examiner",
"occupationalCategory": "23-2099.00"
},
"startDate": "1901",
"endDate": "1906"
},
"@type": "Occupation",
"name": "Professor of Physics",
"educationRequirements": "PhD in Physics"
Example 3
Copied
No Markup
JSON-LD
Structure
Example notes or example HTML without markup.
See JSON example.
Example encoded as
JSON-LD
in a HTML script tag.

Structured representation of the JSON-LD example.
"@context": "https://schema.org/",
"@type": "JobPosting",
"name": "Mobile App Developer",
"hiringOrganization": {
"@type": "Organization",
"name": "ACME Software"
},
"relevantOccupation": {
"@type": "Occupation",
"name": "Software Developers, Applications",
"occupationalCategory": {
"@type": "CategoryCode",
"inCodeSet": {
"@type": "CategoryCodeSet",
"name": "O*Net-SOC",
"dateModified": "2019",
"url": "https://www.onetonline.org/"
},
"codeValue": "15-1132.00",
"name": "Software Developers, Applications",
"url": "https://www.onetonline.org/link/summary/15-1132.00"
Example 4
Copied
No Markup
JSON-LD
Structure
Example notes or example HTML without markup.
See JSON example.
Example encoded as
JSON-LD
in a HTML script tag.

Structured representation of the JSON-LD example.
"@context": "https://schema.org/",
"@type": "Occupation",
"name": "Nurse Practioner",
"educationRequirements": "Graduate degree in nursing",
"occupationalCategory": "29-1171.00",
"occupationLocation": {
"@type": "Country",
"name": "USA",
"sameAs": "https://www.wikidata.org/wiki/Q30"
},
"qualifications": "Registered nurse licensure in state where practicing",
"responsibilities": "Diagnose and treat acute, episodic, or chronic illness, independently or as part of a healthcare team.",
"skills": ["Active listening", "Critical thinking", "Social awareness"],
"estimatedSalary": {
"@type": "MonetaryAmountDistribution",
"duration": "1Y",
"currency": "USD",
"percentile10": 72000,
"percentile25": 86000,
"median": 109000,
"percentile75": 120000,
"percentile90": 140000
Example 5
Copied
No Markup
Microdata
RDFa
JSON-LD
Structure
Example notes or example HTML without markup.

Occupation: Research Scientist

educationRequirements"

PhD or equivalent

Example encoded as
Microdata
embedded in HTML.

Example encoded as
RDFa
embedded in HTML.

Example encoded as
JSON-LD
in a HTML script tag.

Structured representation of the JSON-LD example.
"@context": "https://schema.org/",
"@type": "Occupation",
"name": "Research Scientist",
"qualifications": {
"@type": "EducationalOccupationalCredential",
"educationalLevel": "PhD or equivalent"
Example 6
Copied
No Markup
JSON-LD
Structure
Example notes or example HTML without markup.


Example encoded as
JSON-LD
in a HTML script tag.


Structured representation of the JSON-LD example.
"@context": "https://schema.org/",
"@type": "Occupation",
"occupationalCategory": {
"@type": "CategoryCode",
"inCodeSet": {
"@type": "CategoryCodeSet",
"name": "O*Net-SOC",
"dateModified": "2019",
"url": "https://www.onetonline.org/"
},
"codeValue": "15-1211.00",
"name": "Computer Systems Analysts",
"url": "https://www.onetonline.org/link/summary/15-1121.00"
Terms and conditions
Schema.org
V30.0
2026-03-19