{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/jsonresume/jsonresume.org/master/packages/schema/schema.json",
  "additionalProperties": true,
  "definitions": {
    "iso8601": {
      "type": "string",
      "description": "Similar to the standard date type, but each section after the year is optional. e.g. 2014-06-29 or 2023-04. Every date is optional; omit endDate for a current position or ongoing entry (#309).",
      "pattern": "^([1-2][0-9]{3}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])|[1-2][0-9]{3}-(0[1-9]|1[0-2])|[1-2][0-9]{3})$"
    },
    "custom": {
      "type": "object",
      "description": "Tool- or author-specific data that has no standard field yet (#316). Keys are free-form; namespace them by tool (e.g. \"myTool\": { ... }) to avoid collisions. Themes are not expected to render it, and tools should preserve it unchanged when reading and writing resumes.",
      "additionalProperties": true
    },
    "location": {
      "type": "object",
      "additionalProperties": true,
      "properties": {
        "address": {
          "type": "string",
          "description": "To add multiple address lines, use \n. For example, 1234 Glücklichkeit Straße\nHinterhaus 5. Etage li."
        },
        "postalCode": {
          "type": "string",
          "description": "e.g. 12345"
        },
        "city": {
          "type": "string",
          "description": "e.g. Teststadt"
        },
        "countryCode": {
          "type": "string",
          "description": "code as per ISO-3166-1 ALPHA-2, e.g. US, AU, IN"
        },
        "region": {
          "type": "string",
          "description": "The general region where you live. Can be a US state, or a province, for instance."
        }
      }
    }
  },
  "properties": {
    "$schema": {
      "type": "string",
      "description": "link to the version of the schema that can validate the resume",
      "format": "uri"
    },
    "basics": {
      "type": "object",
      "additionalProperties": true,
      "properties": {
        "name": {
          "type": "string"
        },
        "label": {
          "type": "string",
          "description": "e.g. Web Developer"
        },
        "pronouns": {
          "type": "string",
          "description": "e.g. she/her, they/them (#312)"
        },
        "image": {
          "type": "string",
          "description": "URL (as per RFC 3986) to a image in JPEG or PNG format"
        },
        "email": {
          "type": "string",
          "description": "e.g. thomas@gmail.com",
          "format": "email"
        },
        "phone": {
          "type": "string",
          "description": "Phone numbers are stored as strings so use any format you like, e.g. 712-117-2923"
        },
        "url": {
          "type": "string",
          "description": "URL (as per RFC 3986) to your website, e.g. personal homepage",
          "format": "uri"
        },
        "summary": {
          "type": "string",
          "description": "Write a short 2-3 sentence biography about yourself"
        },
        "location": {
          "$ref": "#/definitions/location"
        },
        "profiles": {
          "type": "array",
          "description": "Specify any number of social networks that you participate in",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
              "network": {
                "type": "string",
                "description": "e.g. Facebook or Twitter"
              },
              "username": {
                "type": "string",
                "description": "e.g. neutralthoughts"
              },
              "url": {
                "type": "string",
                "description": "e.g. http://twitter.example.com/neutralthoughts",
                "format": "uri"
              }
            }
          }
        },
        "custom": {
          "$ref": "#/definitions/custom"
        }
      }
    },
    "objective": {
      "type": "string",
      "description": "Forward-looking career goal, e.g. 'Seeking a senior backend role in climate tech'. Distinct from basics.summary, which describes background (#317)"
    },
    "work": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "name": {
            "type": "string",
            "description": "e.g. Facebook"
          },
          "location": {
            "oneOf": [
              {
                "type": "string",
                "description": "Free text, e.g. Menlo Park, CA"
              },
              {
                "$ref": "#/definitions/location"
              }
            ]
          },
          "description": {
            "type": "string",
            "description": "e.g. Social Media Company"
          },
          "position": {
            "type": "string",
            "description": "e.g. Software Engineer"
          },
          "url": {
            "type": "string",
            "description": "e.g. http://facebook.example.com",
            "format": "uri"
          },
          "startDate": {
            "$ref": "#/definitions/iso8601"
          },
          "endDate": {
            "$ref": "#/definitions/iso8601"
          },
          "summary": {
            "type": "string",
            "description": "Give an overview of your responsibilities at the company"
          },
          "highlights": {
            "type": "array",
            "description": "Specify multiple accomplishments",
            "items": {
              "type": "string",
              "description": "e.g. Increased profits by 20% from 2011-2012 through viral advertising"
            }
          },
          "keywords": {
            "type": "array",
            "description": "Skills, tools or technologies used in this role (#293)",
            "items": {
              "type": "string",
              "description": "e.g. React"
            }
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "volunteer": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "organization": {
            "type": "string",
            "description": "e.g. Facebook"
          },
          "location": {
            "oneOf": [
              {
                "type": "string",
                "description": "Free text, e.g. Berlin, DE"
              },
              {
                "$ref": "#/definitions/location"
              }
            ]
          },
          "position": {
            "type": "string",
            "description": "e.g. Software Engineer"
          },
          "url": {
            "type": "string",
            "description": "e.g. http://facebook.example.com",
            "format": "uri"
          },
          "startDate": {
            "$ref": "#/definitions/iso8601"
          },
          "endDate": {
            "$ref": "#/definitions/iso8601"
          },
          "summary": {
            "type": "string",
            "description": "Give an overview of your responsibilities at the company"
          },
          "highlights": {
            "type": "array",
            "description": "Specify accomplishments and achievements",
            "items": {
              "type": "string",
              "description": "e.g. Increased profits by 20% from 2011-2012 through viral advertising"
            }
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "education": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "institution": {
            "type": "string",
            "description": "e.g. Massachusetts Institute of Technology"
          },
          "location": {
            "oneOf": [
              {
                "type": "string",
                "description": "Free text, e.g. Cambridge, MA"
              },
              {
                "$ref": "#/definitions/location"
              }
            ]
          },
          "url": {
            "type": "string",
            "description": "e.g. http://facebook.example.com",
            "format": "uri"
          },
          "area": {
            "type": "string",
            "description": "e.g. Arts"
          },
          "studyType": {
            "type": "string",
            "description": "e.g. Bachelor"
          },
          "startDate": {
            "$ref": "#/definitions/iso8601"
          },
          "endDate": {
            "$ref": "#/definitions/iso8601"
          },
          "score": {
            "type": "string",
            "description": "grade point average, e.g. 3.67/4.0"
          },
          "courses": {
            "type": "array",
            "description": "List notable courses/subjects",
            "items": {
              "type": "string",
              "description": "e.g. H1302 - Introduction to American history"
            }
          },
          "summary": {
            "type": "string",
            "description": "Thesis topic, honours, notable projects or other context (#292)"
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "awards": {
      "type": "array",
      "description": "Specify any awards you have received throughout your professional career",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "title": {
            "type": "string",
            "description": "e.g. One of the 100 greatest minds of the century"
          },
          "date": {
            "$ref": "#/definitions/iso8601"
          },
          "awarder": {
            "type": "string",
            "description": "e.g. Time Magazine"
          },
          "summary": {
            "type": "string",
            "description": "e.g. Received for my work with Quantum Physics"
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "certificates": {
      "type": "array",
      "description": "Specify any certificates you have received throughout your professional career",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "name": {
            "type": "string",
            "description": "e.g. Certified Kubernetes Administrator"
          },
          "date": {
            "$ref": "#/definitions/iso8601"
          },
          "url": {
            "type": "string",
            "description": "e.g. http://example.com",
            "format": "uri"
          },
          "credentialId": {
            "type": "string",
            "description": "Credential or licence number used to verify the certificate, e.g. a licence number or a certification ID (#590)"
          },
          "issuer": {
            "type": "string",
            "description": "e.g. CNCF"
          },
          "expiryDate": {
            "$ref": "#/definitions/iso8601"
          },
          "summary": {
            "type": "string",
            "description": "What the certificate covers (#590)"
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "publications": {
      "type": "array",
      "description": "Specify your publications through your career",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "name": {
            "type": "string",
            "description": "e.g. The World Wide Web"
          },
          "authors": {
            "type": "array",
            "description": "Authors in published order, including the resume owner. e.g. ['Richard Hendriks', 'Bertram Gilfoyle']",
            "items": {
              "type": "string"
            }
          },
          "publisher": {
            "type": "string",
            "description": "e.g. IEEE, Computer Magazine. For talks, the event name"
          },
          "releaseDate": {
            "$ref": "#/definitions/iso8601"
          },
          "volume": {
            "type": "string",
            "description": "e.g. 12"
          },
          "issue": {
            "type": "string",
            "description": "e.g. 3"
          },
          "pages": {
            "type": "string",
            "description": "e.g. 45-67"
          },
          "identifiers": {
            "type": "object",
            "description": "Persistent identifiers keyed by scheme, e.g. doi, isbn, arxiv, pmid",
            "additionalProperties": {
              "type": "string"
            },
            "properties": {
              "doi": {
                "type": "string",
                "description": "e.g. 10.1000/182"
              },
              "isbn": {
                "type": "string",
                "description": "e.g. 978-3-7502-4718-5"
              },
              "arxiv": {
                "type": "string",
                "description": "e.g. 2101.00001"
              }
            }
          },
          "url": {
            "type": "string",
            "description": "e.g. http://www.computer.org.example.com/csdl/mags/co/1996/10/rx069-abs.html",
            "format": "uri"
          },
          "summary": {
            "type": "string",
            "description": "Short summary of publication. e.g. Discussion of the World Wide Web, HTTP, HTML."
          },
          "type": {
            "type": "string",
            "description": "e.g. 'article', 'book', 'patent', 'thesis', 'talk' (#295)"
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "skills": {
      "type": "array",
      "description": "List out your professional skill-set",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "name": {
            "type": "string",
            "description": "e.g. Web Development"
          },
          "level": {
            "type": "string",
            "description": "e.g. Master"
          },
          "keywords": {
            "type": "array",
            "description": "List some keywords pertaining to this skill",
            "items": {
              "type": "string",
              "description": "e.g. HTML"
            }
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "languages": {
      "type": "array",
      "description": "List any other languages you speak",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "language": {
            "type": "string",
            "description": "e.g. English, Spanish"
          },
          "fluency": {
            "type": "string",
            "description": "e.g. Fluent, Beginner"
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "interests": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "name": {
            "type": "string",
            "description": "e.g. Philosophy"
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "e.g. Friedrich Nietzsche"
            }
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "references": {
      "type": "array",
      "description": "List references you have received",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "name": {
            "type": "string",
            "description": "e.g. Timothy Cook"
          },
          "reference": {
            "type": "string",
            "description": "e.g. Joe blogs was a great employee, who turned up to work at least once a week. He exceeded my expectations when it came to doing nothing."
          },
          "relationship": {
            "type": "string",
            "description": "How the referee knows you. e.g. Manager, Peer, Client, Thesis advisor"
          },
          "organization": {
            "type": "string",
            "description": "Where you worked together. e.g. Pied Piper"
          },
          "date": {
            "$ref": "#/definitions/iso8601"
          },
          "availableOnRequest": {
            "type": "boolean",
            "description": "Show 'available on request' rather than publishing the reference. Contact details are deliberately not part of the schema"
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "projects": {
      "type": "array",
      "description": "Specify career projects",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "name": {
            "type": "string",
            "description": "e.g. The World Wide Web"
          },
          "summary": {
            "type": "string",
            "description": "Short summary of the project, consistent with summary in other sections (#296). e.g. Collated works of 2017."
          },
          "description": {
            "type": "string",
            "description": "Deprecated alias of summary, kept for compatibility; when both are set, summary wins (#296). e.g. Collated works of 2017."
          },
          "highlights": {
            "type": "array",
            "description": "Specify multiple features",
            "items": {
              "type": "string",
              "description": "e.g. Directs you close but not quite there"
            }
          },
          "keywords": {
            "type": "array",
            "description": "Specify special elements involved",
            "items": {
              "type": "string",
              "description": "e.g. AngularJS"
            }
          },
          "startDate": {
            "$ref": "#/definitions/iso8601"
          },
          "endDate": {
            "$ref": "#/definitions/iso8601"
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "e.g. http://www.computer.org/csdl/mags/co/1996/10/rx069-abs.html"
          },
          "roles": {
            "type": "array",
            "description": "Specify your role on this project or in company",
            "items": {
              "type": "string",
              "description": "e.g. Team Lead, Speaker, Writer"
            }
          },
          "entity": {
            "type": "string",
            "description": "Specify the relevant company/entity affiliations e.g. 'greenpeace', 'corporationXYZ'"
          },
          "type": {
            "type": "string",
            "description": " e.g. 'volunteering', 'presentation', 'talk', 'application', 'conference'"
          },
          "custom": {
            "$ref": "#/definitions/custom"
          }
        }
      }
    },
    "meta": {
      "type": "object",
      "description": "The schema version and any other tooling configuration lives here",
      "additionalProperties": true,
      "properties": {
        "canonical": {
          "type": "string",
          "description": "URL (as per RFC 3986) to latest version of this document",
          "format": "uri"
        },
        "version": {
          "type": "string",
          "description": "A version field which follows semver - e.g. v1.0.0"
        },
        "lastModified": {
          "type": "string",
          "description": "Using ISO 8601 with YYYY-MM-DDThh:mm:ss"
        }
      }
    },
    "custom": {
      "$ref": "#/definitions/custom"
    }
  },
  "title": "Resume Schema",
  "type": "object"
}
