Schema Resume v1.3.0

Overview

Schema Resume provides a self-hosted, comprehensive JSON-LD schema for representing professional resumes and CVs. It enables easy parsing, validation and exchange of resume data between systems with semantic web integration.

Perfect for job boards, applicant tracking systems, resume builders and HR platforms. No external dependencies required — all schema definitions are self-contained.

Getting Started

Point a JSON document at the schema and you are done — there is nothing to install and no service to call:

{
  "$schema": "https://schema-resume.org/1.2/schema.json",
  "@context": "https://schema-resume.org/1.2/context.jsonld",
  "basics": {
    "name": "Your Name",
    "email": "your.email@example.com"
  }
}

That is a valid Schema Resume document. Everything below is optional detail.

A fuller JSON example

{
  "@context": "https://schema-resume.org/schema.json",
  "$schema": "https://schema-resume.org/schema.json",
  "basics": {
    "name": "John Doe",
    "label": "Software Engineer",
    "email": "john.doe@example.com",
    "summary": "Experienced software engineer..."
  },
  "work": [
    {
      "name": "Tech Corp",
      "position": "Senior Software Engineer",
      "startDate": "2020-03",
      "highlights": [
        "Reduced API response time by 40%"
      ]
    }
  ]
}

XML example

<?xml version="1.0" encoding="UTF-8"?>
<resume xmlns="https://schema-resume.org/xml/1.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="https://schema-resume.org/xml/1.0
                            https://schema-resume.org/xml/1.0/schema-resume.xsd">
  <basics>
    <name>John Doe</name>
    <label>Software Engineer</label>
    <email>john.doe@example.com</email>
    <summary>Experienced software engineer...</summary>
  </basics>
  <work>
    <name>Tech Corp</name>
    <position>Senior Software Engineer</position>
    <startDate>2020-03</startDate>
  </work>
</resume>

Validation

JSON, in the browser: use the online validator for instant validation with detailed error messages and suggestions.

JSON, on the command line:

npm install -g ajv-cli
ajv validate -s schema.json -d your-resume.json

XML:

# Using xmllint (Linux/macOS)
xmllint --schema https://schema-resume.org/xml/1.0/schema-resume.xsd your-resume.xml --noout

# Using Python (lxml)
python -c "from lxml import etree; import requests; xsd = etree.XMLSchema(etree.parse(requests.get('https://schema-resume.org/xml/1.0/schema-resume.xsd', stream=True).raw)); print('Valid!' if xsd.validate(etree.parse('your-resume.xml')) else xsd.error_log)"

Features

Schema URLs

All schema files are self-hosted alongside this documentation:

JSON Schema

XML Schema (XSD)

Pinning a version

The URLs above track the current release. Every version is also published at a permanent address, so a document can pin the specification it was written against and never be changed underneath it:

Use the pinned URL in stored documents and in CI; use the latest URL when you want to follow the specification. See versioning and stability for what may change between releases.

Schema Sections

• basics — personal information, contact details, nationalities and work authorization
• work — work experience and employment history
• volunteer — volunteer work and community involvement
• education — academic background and qualifications
• awards — professional awards and recognitions
• certificates — professional certifications
• publications — published works and articles
• skills — technical and professional skills with experience levels
• tools — specific software and platforms used professionally
• languages — language proficiencies
• interests — personal interests and hobbies
• references — professional references
• projects — personal and professional projects
• meta — schema metadata and versioning

Documentation

Every guide below is generated from the repository's docs/ folder.

Resources

Schema Properties

The schema includes the following main sections: