What Is a Job Description in HR?
What is a job description in HR? The internal document that defines a role, its duties, qualifications, reporting line and pay grade, behind each posting.
Dvir Atias
Founder, JobsPipe
What is a job description in HR? It is the document that defines a role: title, purpose, responsibilities, required and preferred qualifications, reporting line, and terms such as location, employment type and pay grade. HR keeps it as the internal record of the position, and the job posting that candidates see is built from it.
What a job description in HR is used for
- Defining the role. The hiring manager drafts it with HR, often from a job analysis of what the work involves and a competency framework for the level. It is the agreed statement of what the position exists to do, before anyone is hired into it.
- Grading and pay. Compensation teams place the description in a level and a salary band, benchmark it against the same role at other companies and use it in pay equity reviews. The description, not the person, is the unit being compared.
- Recruiting. When a requisition opens, the description becomes the core of the posting: the description plus a pitch for the company, the application route and a posting date. The posting is the public artefact; the description behind it may hold internal details that never reach the board.
- Performance and compliance. Reviews measure the person against the responsibilities on file. In many jurisdictions the description supports classification decisions, accommodation requests and the paper trail HR needs in a dispute, which is why HR insists on a signed-off version.
- Keeping it current. Descriptions drift as the job changes, and an outdated one causes trouble at review time and in hiring. Most teams re-read it whenever a requisition opens; the cadence question is covered in how often should job descriptions be updated.
The distinction people trip on is description versus posting versus person specification. The description defines the role, the posting advertises it and the specification profiles the ideal candidate. In practice a posting collapses all three into one page, which is why the terms are used loosely. The general definition, with the standard sections, is in what is a job description. For HR teams the useful external question is what other employers write for the same role: the responsibilities they list, the qualifications they require, the pay they state and the skills they name. A corpus of real postings answers that better than a template library.
Where JobsPipe fits
JobsPipe is a jobs data API that collects live postings from LinkedIn, Indeed, Y Combinator, Naukri, Workday, Greenhouse, Workable, SmartRecruiters, Ashby, Lever and Paylocity, returns them as one schema with closure tracking and a ghost score, and includes a free tier of 1,000 jobs a month. Every record carries the posting text, and JobsPipe parses it into technology_slugs, a normalized seniority and a salary range where one is stated, so descriptions for a role can be compared as fields rather than read one by one. How to assemble that set is in job description dataset. To pull descriptions that name a specific duty:
curl -X POST https://api.jobspipe.dev/v1/jobs/search \
-H "Authorization: Bearer $JOBSPIPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "job_title_or": ["hr business partner"], "description_or": ["workforce planning"], "posted_at_max_age_days": 30, "limit": 50 }'Benchmark your job descriptions against live postings - free tier included.
Get a free API keyFrequently Asked Questions
Who writes the job description?
Usually the hiring manager drafts it and HR edits it into the company's format, adding the level, pay band, reporting line and any compliance language. Compensation teams check the grade, and in larger companies a job architecture or competency framework constrains the wording so roles can be compared across teams.
What is the difference between a job description and a job posting?
The description is the internal document that defines the role. The posting is the advertisement built from it: the description plus a pitch for the company, the application route and a posting date, published on a career site or board. Postings often omit internal details such as the grade and add material the description never had.
How is a job description used in pay decisions?
Compensation teams place each description in a level and a salary band and benchmark it against equivalent roles at other employers. Pay equity reviews compare people holding the same description. Because the description is the unit of comparison, an outdated one can put a role in the wrong band.

