What is a job description?

A job description is a written statement of what a role involves: its title, purpose, main responsibilities, the skills and qualifications required, who it reports to, and its terms such as location, employment type and pay. Employers use it internally to define the position and externally as the core of a job posting.

The standard parts are a title, a summary of the role's purpose, a responsibilities section, a qualifications section split into required and preferred, the reporting line and team, and the terms: location, remote or on-site arrangement, employment type, salary range and benefits. HR teams often add a grade or level, a physical or working-conditions note, and the date the description was last reviewed, because descriptions drift as the job changes and an outdated one causes trouble at review and dispute time.

A job description, a job posting and a job specification are related but different. The description defines the role. The posting is the advertisement built on it: the description plus a pitch for the company, the application route and a posting date, published on a board or careers site. The specification, or person spec, is the profile of the ideal candidate, the competencies and experience the hiring manager will assess against. In practice most postings collapse all three into one page, which is why the terms are used loosely.

For data purposes the posting is what gets collected, and the description is the text inside it. JobsPipe parses that text on every posting from the collected boards into fields such as technology_slugs, a normalized seniority and a parsed salary in min_annual_salary_usd, and scores it: a thin description is one of the warning signs in the ghost_score. Search the text directly with description_or when a phrase matters more than a field.

The full treatment is on Job titles and descriptions.