FRESH Resume Schema

Browse every section and field ResumeForge understands. Each field shows its type, whether it's required, allowed values, and a concrete example from a sample “John Doe” CV.

* requiredobject nested fieldsarray repeatable liste.g. example value
name*string

The candidate's name as it should appear on the resume.

e.g.John Doe
meta*object

The 'meta' section contains metadata information for the resume, including the resume version, schema, and any other fields required by tools.

format*string

The canonical resume format and version. Should be 'FRESH@0.1.0'.

e.g.FRESH@0.1.0
versionstring

The semantic version number for this resume.

e.g.1.0.0
infoobject

The 'info' section contains basic summary information for the candidate, including an optional label or job title, candidate photo, summary, and quote.

labelstring

A label for this resume, such as 'Full-Stack Developer'.

e.g.Senior Software Engineer
classstring

Profession type or 'character class'.

e.g.Software Development
imagestring

URL or path to your picture in JPEG, PNG, GIF, or BMP format.

e.g.https://johndoe.dev/avatar.jpg
briefstring

A short description or summary of yourself as a candidate.

e.g.Experienced full-stack developer with a passion for building scalable, reliable web applications.
quotestring

Candidate quote or byline.

e.g.Turning complex problems into elegant solutions.
dispositionobject

Describes the candidate's general attitude towards new employment opportunities (travel, relocation, schedule, etc.).

travelinteger

Percentage of time willing to travel (0 to 100).

e.g.25
authorizationstring

Work authorization: citizen, work visa, etc.

e.g.citizen
commitmentarray

Types of work desired: contract, perm, seasonal, etc.

e.g.full-time, contract
remoteboolean

Open to remote employment opportunities.

e.g.true
relocationobject
willingstring | boolean

Willingness to relocate.

e.g.true
destinationsarray

Preferred destinations for relocation

e.g.Berlin, Amsterdam
contactobject

The 'contact' section contains the candidate's contact information, including phone numbers, emails, websites, IMs, and custom contact types.

emailstring

Primary contact email in valid email format.

e.g.john.doe@example.com
phonestring

Primary phone number.

e.g.+1 (555) 123-4567
websitestring

Website, blog, or home page.

e.g.https://johndoe.dev
otherarrayof object

each item

labelstring

A label for this contact information.

e.g.Work
categorystring

Type of contact info: email, phone, url, postal, or IM.

e.g.email
valuestring

Phone number, email address, website, etc.

e.g.j.doe@techcorp.com
locationobject

The 'location' section, when present, contains the candidate's location and address info.

addressstring

Your full postal address.

e.g.123 Market Street
codestring

Postal or other official routing code.

e.g.94105
citystring

Your home city.

e.g.San Francisco
countrystring

Two-digit country code (US, AU, UK, IN, etc.).

e.g.US
regionstring

Your state, region, or province.

e.g.CA
employmentobject

The 'employment' section describes the candidate's formal employment history.

summarystring

Summary of overall employment.

e.g.10+ years of experience in software development.
historyarrayof object

each item

employer*string

Employer name.

e.g.Tech Corp
positionstring

Your position or formal job title.

e.g.Senior Software Engineer
urlstring

Employer website.

e.g.https://techcorp.com
startstringdate

Date you began work (YYYY-MM-DD).

e.g.2020-01-01
endstringdate

Date you finished work (YYYY-MM-DD).

e.g.2023-12-31
summarystring

A summary of your achievements and responsibilities under this employer.

e.g.Led development of core platform features.
highlightsarray

Noteworthy achievements and/or highlights.

e.g.Architected and implemented a microservices infrastructure., Improved system …
locationstring

Location of the job or position, e.g., 'San Francisco, CA'.

e.g.San Francisco, CA
keywordsarray

Keywords associated with this position.

e.g.TypeScript, Go, Kubernetes
projectsarrayof object

Describes the candidate's project history — specific projects, paid or unpaid.

each item

title*string

Project name or code-name.

e.g.Open Resume Toolkit
categorystring

Project type: open-source, private, side project, etc.

e.g.open-source
descriptionstring

Project description or summary.

e.g.A toolkit for parsing and rendering FRESH resumes.
summarystring

A summary of your achievements and responsibilities on the project.

e.g.Created and maintained a widely-used resume toolkit.
rolestring

Your role on the project: Contributor, Creator, etc.

e.g.Creator
urlstring

Project URL.

e.g.https://github.com/johndoe/open-resume
mediaarrayof object

Media associated with this project.

each item

category*string

Media category: image, thumbnail, screenshot, etc.

e.g.screenshot
namestring

Friendly media name.

e.g.Dashboard
urlstring

Media link, path, or location.

e.g.https://johndoe.dev/shot.png
repostring

Repo URL.

e.g.https://github.com/johndoe/open-resume
startstringdate

Date your involvement began (YYYY-MM-DD).

e.g.2019-03-01
endstringdate

Date your involvement ended (YYYY-MM-DD).

e.g.2021-08-01
highlightsarray

Noteworthy project-related achievements and/or highlights.

e.g.Reached 5k GitHub stars., Adopted by 3 companies.
locationstring

Freeform location, e.g., 'San Francisco, CA'.

e.g.Remote
keywordsarray

Keywords associated with this project.

e.g.TypeScript, JSON Schema
skillsobject

A description of the candidate's formal skills and capabilities.

setsarrayof object

each item

name*string

Name of the skillset: 'Programming', 'Project Management', etc.

e.g.Programming Languages
levelenum

Level of mastery of this skill.

one of:BeginnerIntermediateAdvancedExpert
e.g.Expert
skills*array
e.g.JavaScript, TypeScript, Python, Go
listarrayof object

each item

name*string

The name or title of the skill.

e.g.Kubernetes
levelenum

Level of mastery of this skill.

one of:BeginnerIntermediateAdvancedExpert
e.g.Advanced
summarystring

A short summary of your experience with this skill.

e.g.Production cluster operations.
yearsnumber

Number of years you've used the skill.

e.g.4
serviceobject

Describes the candidate's overall service history (volunteer, military, etc.).

summarystring

Summary of overall service/volunteer experience.

e.g.Volunteer mentor and open-source contributor.
historyarrayof object

each item

categorystring

Type of service work, e.g. volunteer or military.

e.g.volunteer
organization*string

The service organization, e.g. Red Cross or National Guard.

e.g.Code for America
positionstring

Formal service role.

e.g.Mentor
urlstring

Organization website.

e.g.https://codeforamerica.org
startstringdate

Date joined (YYYY-MM-DD).

e.g.2018-01-01
endstringdate

Date left (YYYY-MM-DD).

e.g.2020-01-01
summarystring

A summary of achievements and responsibilities.

e.g.Mentored junior developers on civic-tech projects.
highlightsarray

Noteworthy achievements and/or highlights.

e.g.Mentored 12 developers.
keywordsarray

Keywords associated with this service.

e.g.Mentoring, Civic Tech
locationstring

Location, e.g. 'San Francisco, CA' or 'Tokyo'.

e.g.San Francisco, CA
educationobject

Describes the candidate's formal education (college, continuing ed, etc.).

summarystring

Summary of overall education.

e.g.Computer science degree with honors.
level*string

Highest level of education obtained (none, diploma, some-college, degree).

e.g.degree
degreestring

Degree, if any (BSCS, BA, etc.).

e.g.BSCS
historyarrayof object

each item

titlestring

A freeform title for this education (short name of degree, etc.).

e.g.B.Sc. Computer Science
institution*string

College or school name.

e.g.University of Technology
areastring

E.g. Arts

e.g.Computer Science
studyTypestring

E.g. Bachelor

e.g.Bachelor
startstringdate

Start date (YYYY-MM-DD).

e.g.2010-09-01
endstringdate

End date (YYYY-MM-DD).

e.g.2014-05-31
gradestring

Grade or GPA.

e.g.3.9 GPA
curriculumarray

Notable courses, subjects, and experiences.

e.g.Algorithms, Distributed Systems
urlstring

School website or URL.

e.g.https://uot.edu
summarystring

A short summary of this education experience.

e.g.Focused on distributed systems and algorithms.
keywordsarray

Keywords associated with this education.

e.g.Algorithms, Systems
highlightsarray

Noteworthy achievements and/or highlights.

e.g.Graduated summa cum laude.
locationstring

Freeform location, e.g., 'San Francisco, CA'.

e.g.Boston, MA
socialarrayof object

Describes the candidate's participation in social networking (GitHub, Facebook, etc.).

each item

network*string

The name of the social network (Facebook, GitHub, etc.).

e.g.GitHub
user*string

The username or handle on the social network.

e.g.johndoe
url*string

Profile page URL.

e.g.https://github.com/johndoe
labelstring

A friendly label.

e.g.GitHub
recognitionarrayof object

Describes the candidate's public or professional awards and honors.

each item

categorystring

Type of recognition: award, honor, prize, etc.

e.g.award
title*string

Title of the award or recognition.

e.g.Engineer of the Year
datestringdate

Date awarded (YYYY-MM-DD).

e.g.2022-11-01
fromstring

Name of the awarding company, institution, or person.

e.g.Tech Corp
summarystring

A brief description of the award and why you received it.

e.g.Awarded for outstanding technical leadership.
urlstring

Associated URL.

e.g.https://techcorp.com/awards
writingarrayof object

Describes the candidate's writing and publication history (blogs, essays, books, etc.).

each item

title*string

Title of the article, essay, or book.

e.g.Scaling Microservices in Practice
categorystring

One of 'book', 'article', 'essay', 'blog post', or 'series'.

e.g.article
publisherstring | object

Publisher of the article, essay, or book.

namestring

Publisher name.

e.g.Dev Monthly
urlstring

Publisher website or URL.

e.g.https://devmonthly.com
datestringdate

Publication date (YYYY-MM-DD).

e.g.2021-06-15
urlstring

Website or URL of this publication.

e.g.https://devmonthly.com/scaling
summarystring

A brief summary of the publication.

e.g.A practical guide to scaling microservices.
readingarrayof object

Describes the candidate's reading habits, showing familiarity with industry publications.

each item

title*string

Title of the book, blog, or article.

e.g.Designing Data-Intensive Applications
categorystring

Type of reading: book, article, blog, magazine, etc.

e.g.book
urlstring

URL of the book, blog, or article.

e.g.https://dataintensive.net
authorstring | array

Author(s) of the book, blog, or article

e.g.Martin Kleppmann
datestringdate

Publication date (YYYY-MM-DD).

e.g.2017-03-16
summarystring

A brief description of the reading.

e.g.Essential reading on data systems.
speakingarrayof object

Describes speaking engagements and presentations.

each item

titlestring

Speaking engagement title.

e.g.Building Resilient Systems
event*string

Event at which you presented.

e.g.DevConf 2022
locationstring

Location of the event, e.g., 'San Francisco, CA'.

e.g.Berlin, Germany
datestringdate

Presentation date (YYYY-MM-DD).

e.g.2022-09-20
highlightsarray

Noteworthy achievements or highlights.

e.g.Best talk award.
keywordsarray

Keywords associated with this speaking engagement.

e.g.Resilience, Distributed Systems
summarystring

A description of this speaking engagement.

e.g.A talk on designing for failure.
governancearrayof object

Describes leadership, board, or committee roles.

each item

summarystring

Summary of your governance at this organization.

e.g.Served on the technical steering committee.
categorystring

Type of governance: committee, board, standards group, etc.

e.g.committee
rolestring

Governance role: board member, director, etc.

e.g.Member
organizationstring

The organization.

e.g.Open Resume Foundation
startstringdate

Start date (YYYY-MM-DD).

e.g.2021-01-01
endstringdate

End date (YYYY-MM-DD).

e.g.2023-01-01
keywordsarray

Keywords associated with this governance stint.

e.g.Standards
highlightsarray

Noteworthy achievements and/or highlights.

e.g.Shaped the FRESH schema roadmap.
languagesarrayof object

Describes the candidate's knowledge of world languages.

each item

language*string

The name of the language: English, Spanish, etc.

e.g.English
levelstring

Level of fluency, from 1 to 10 (or freeform).

e.g.Native
yearsnumber

Amount of time language spoken.

e.g.30
samplesarrayof object

Demonstration of the candidate's portfolio or work product.

each item

title*string

Title or descriptive name.

e.g.Portfolio Website
summarystring

A brief description of the sample.

e.g.Personal portfolio built with Next.js.
urlstring

URL of the sample.

e.g.https://johndoe.dev
datestringdate

Release date (YYYY-MM-DD).

e.g.2023-02-01
highlightsarray

Noteworthy achievements for this sample.

e.g.Lighthouse score 100.
keywordsarray

Keywords associated with this sample.

e.g.Next.js, Design
referencesarrayof object

Describes the candidate's personal, professional, and/or technical references.

each item

name*string

Full name of the person giving the reference.

e.g.Jane Smith
rolestring

Occupation or relationship to the candidate.

e.g.Engineering Manager
categorystring

Type of reference (professional, technical, personal).

e.g.professional
privateboolean

Is this a private reference?

e.g.false
summarystring

Summary information for this reference.

e.g.Worked directly with John for 3 years.
contactarrayof object

each item

labelstring

Friendly label for this piece of contact info.

e.g.Email
categorystring

Type of contact info (phone, email, web, etc.).

e.g.email
valuestring

The email address, phone number, etc.

e.g.jane.smith@techcorp.com
testimonialsarrayof object

Public testimonials of the candidate's professionalism and character.

each item

name*string

Full name of the person giving the reference.

e.g.Jane Smith
quote*string

A quoted reference, e.g. 'Susan was an excellent team leader...'

e.g.John is one of the most reliable engineers I've worked with.
categorystring

Type of reference: personal, professional, or technical.

e.g.professional
privateboolean

Public reference or private contact?

e.g.false
interestsarrayof object

The 'interests' section provides a sampling of the candidate's hobbies or passions.

each item

name*string

The name/title of the interest or hobby.

e.g.Photography
summarystring
e.g.Landscape and street photography.
keywordsarray

Keywords associated with this interest.

e.g.Travel, Editing
extracurriculararrayof object

Describes the candidate's involvement with industry-related events/activities outside of work.

each item

title*string

Title of the extracurricular activity.

e.g.Hackathon Organizer
activity*string

The extracurricular activity.

e.g.Organizing local hackathons.
locationstring

City, state, or other freeform location.

e.g.San Francisco, CA
startstringdate

Start date (YYYY-MM-DD).

e.g.2019-01-01
endstringdate

End date (YYYY-MM-DD).

e.g.2022-01-01
affiliationobject

Describes the candidate's membership in groups, clubs, organizations, and professional associations.

summarystring

Optional summary of affiliation and membership experience.

e.g.Member of professional engineering associations.
historyarrayof object

each item

categorystring

Type of affiliation: club, union, meetup, etc.

e.g.association
organization*string

The name of the organization or group.

e.g.ACM
rolestring

Your role in the organization or group.

e.g.Member
urlstring

Organization website.

e.g.https://acm.org
startstringdate-time

Date affiliation began (YYYY-MM-DD).

e.g.2015-01-01
endstringdate

Date affiliation ended (YYYY-MM-DD).

e.g.2024-01-01
summarystring

A summary of achievements and responsibilities.

e.g.Active member of the ACM.
highlightsarray

Noteworthy achievements and/or highlights.

e.g.Attended annual conferences.
keywordsarray

Keywords associated with this affiliation.

e.g.Computing
locationstring

Freeform location, e.g., 'San Francisco, CA'.

e.g.Global
Full sample CV (John Doe) — JSON
{
  "name": "John Doe",
  "meta": {
    "format": "FRESH@0.1.0",
    "version": "1.0.0"
  },
  "info": {
    "label": "Senior Software Engineer",
    "class": "Software Development",
    "image": "https://johndoe.dev/avatar.jpg",
    "brief": "Experienced full-stack developer with a passion for building scalable, reliable web applications.",
    "quote": "Turning complex problems into elegant solutions."
  },
  "disposition": {
    "travel": 25,
    "authorization": "citizen",
    "commitment": [
      "full-time",
      "contract"
    ],
    "remote": true,
    "relocation": {
      "willing": true,
      "destinations": [
        "Berlin",
        "Amsterdam"
      ]
    }
  },
  "contact": {
    "email": "john.doe@example.com",
    "phone": "+1 (555) 123-4567",
    "website": "https://johndoe.dev",
    "other": [
      {
        "label": "Work",
        "category": "email",
        "value": "j.doe@techcorp.com"
      }
    ]
  },
  "location": {
    "address": "123 Market Street",
    "code": "94105",
    "city": "San Francisco",
    "country": "US",
    "region": "CA"
  },
  "employment": {
    "summary": "10+ years of experience in software development.",
    "history": [
      {
        "employer": "Tech Corp",
        "position": "Senior Software Engineer",
        "url": "https://techcorp.com",
        "start": "2020-01-01",
        "end": "2023-12-31",
        "summary": "Led development of core platform features.",
        "highlights": [
          "Architected and implemented a microservices infrastructure.",
          "Improved system performance by 40% through optimization."
        ],
        "location": "San Francisco, CA",
        "keywords": [
          "TypeScript",
          "Go",
          "Kubernetes"
        ]
      }
    ]
  },
  "projects": [
    {
      "title": "Open Resume Toolkit",
      "category": "open-source",
      "description": "A toolkit for parsing and rendering FRESH resumes.",
      "summary": "Created and maintained a widely-used resume toolkit.",
      "role": "Creator",
      "url": "https://github.com/johndoe/open-resume",
      "media": [
        {
          "category": "screenshot",
          "name": "Dashboard",
          "url": "https://johndoe.dev/shot.png"
        }
      ],
      "repo": "https://github.com/johndoe/open-resume",
      "start": "2019-03-01",
      "end": "2021-08-01",
      "highlights": [
        "Reached 5k GitHub stars.",
        "Adopted by 3 companies."
      ],
      "location": "Remote",
      "keywords": [
        "TypeScript",
        "JSON Schema"
      ]
    }
  ],
  "skills": {
    "sets": [
      {
        "name": "Programming Languages",
        "level": "Expert",
        "skills": [
          "JavaScript",
          "TypeScript",
          "Python",
          "Go"
        ]
      }
    ],
    "list": [
      {
        "name": "Kubernetes",
        "level": "Advanced",
        "summary": "Production cluster operations.",
        "years": 4
      }
    ]
  },
  "service": {
    "summary": "Volunteer mentor and open-source contributor.",
    "history": [
      {
        "category": "volunteer",
        "organization": "Code for America",
        "position": "Mentor",
        "url": "https://codeforamerica.org",
        "start": "2018-01-01",
        "end": "2020-01-01",
        "summary": "Mentored junior developers on civic-tech projects.",
        "highlights": [
          "Mentored 12 developers."
        ],
        "keywords": [
          "Mentoring",
          "Civic Tech"
        ],
        "location": "San Francisco, CA"
      }
    ]
  },
  "education": {
    "summary": "Computer science degree with honors.",
    "level": "degree",
    "degree": "BSCS",
    "history": [
      {
        "title": "B.Sc. Computer Science",
        "institution": "University of Technology",
        "area": "Computer Science",
        "studyType": "Bachelor",
        "start": "2010-09-01",
        "end": "2014-05-31",
        "grade": "3.9 GPA",
        "curriculum": [
          "Algorithms",
          "Distributed Systems"
        ],
        "url": "https://uot.edu",
        "summary": "Focused on distributed systems and algorithms.",
        "keywords": [
          "Algorithms",
          "Systems"
        ],
        "highlights": [
          "Graduated summa cum laude."
        ],
        "location": "Boston, MA"
      }
    ]
  },
  "social": [
    {
      "network": "GitHub",
      "user": "johndoe",
      "url": "https://github.com/johndoe",
      "label": "GitHub"
    }
  ],
  "recognition": [
    {
      "category": "award",
      "title": "Engineer of the Year",
      "date": "2022-11-01",
      "from": "Tech Corp",
      "summary": "Awarded for outstanding technical leadership.",
      "url": "https://techcorp.com/awards"
    }
  ],
  "writing": [
    {
      "title": "Scaling Microservices in Practice",
      "category": "article",
      "publisher": {
        "name": "Dev Monthly",
        "url": "https://devmonthly.com"
      },
      "date": "2021-06-15",
      "url": "https://devmonthly.com/scaling",
      "summary": "A practical guide to scaling microservices."
    }
  ],
  "reading": [
    {
      "title": "Designing Data-Intensive Applications",
      "category": "book",
      "url": "https://dataintensive.net",
      "author": "Martin Kleppmann",
      "date": "2017-03-16",
      "summary": "Essential reading on data systems."
    }
  ],
  "speaking": [
    {
      "title": "Building Resilient Systems",
      "event": "DevConf 2022",
      "location": "Berlin, Germany",
      "date": "2022-09-20",
      "highlights": [
        "Best talk award."
      ],
      "keywords": [
        "Resilience",
        "Distributed Systems"
      ],
      "summary": "A talk on designing for failure."
    }
  ],
  "governance": [
    {
      "summary": "Served on the technical steering committee.",
      "category": "committee",
      "role": "Member",
      "organization": "Open Resume Foundation",
      "start": "2021-01-01",
      "end": "2023-01-01",
      "keywords": [
        "Standards"
      ],
      "highlights": [
        "Shaped the FRESH schema roadmap."
      ]
    }
  ],
  "languages": [
    {
      "language": "English",
      "level": "Native",
      "years": 30
    },
    {
      "language": "German",
      "level": "B2",
      "years": 5
    }
  ],
  "samples": [
    {
      "title": "Portfolio Website",
      "summary": "Personal portfolio built with Next.js.",
      "url": "https://johndoe.dev",
      "date": "2023-02-01",
      "highlights": [
        "Lighthouse score 100."
      ],
      "keywords": [
        "Next.js",
        "Design"
      ]
    }
  ],
  "references": [
    {
      "name": "Jane Smith",
      "role": "Engineering Manager",
      "category": "professional",
      "private": false,
      "summary": "Worked directly with John for 3 years.",
      "contact": [
        {
          "label": "Email",
          "category": "email",
          "value": "jane.smith@techcorp.com"
        }
      ]
    }
  ],
  "testimonials": [
    {
      "name": "Jane Smith",
      "quote": "John is one of the most reliable engineers I've worked with.",
      "category": "professional",
      "private": false
    }
  ],
  "interests": [
    {
      "name": "Photography",
      "summary": "Landscape and street photography.",
      "keywords": [
        "Travel",
        "Editing"
      ]
    }
  ],
  "extracurricular": [
    {
      "title": "Hackathon Organizer",
      "activity": "Organizing local hackathons.",
      "location": "San Francisco, CA",
      "start": "2019-01-01",
      "end": "2022-01-01"
    }
  ],
  "affiliation": {
    "summary": "Member of professional engineering associations.",
    "history": [
      {
        "category": "association",
        "organization": "ACM",
        "role": "Member",
        "url": "https://acm.org",
        "start": "2015-01-01",
        "end": "2024-01-01",
        "summary": "Active member of the ACM.",
        "highlights": [
          "Attended annual conferences."
        ],
        "keywords": [
          "Computing"
        ],
        "location": "Global"
      }
    ]
  }
}