Article · Getting started

Versions and what their states mean

How a job description moves from draft to published, who sees it on the way, and why a published version never changes.

Updated 31 October 2026

A job description is a series of versions. Only one is open at a time: version 1 while it is first written, then a new version each time the published one needs changing. Publishing locks a version. When the next one is published, the earlier one becomes superseded and stays readable.

What the states mean

StateMeaning
DraftBeing written. The people working on it can change it
In reviewSubmitted, and waiting at a stage of its workflow, for example In review: Review (stage 1 of 2). Nobody can change it
Approved, not yet publishedEvery stage has approved it. HR can publish it
PublishedThe version everyone reads
SupersededAn earlier published version, kept for the record
DiscardedA draft nobody wanted, kept read-only until its purge date

Who sees what

Everyone with access reads published and superseded versions. A draft, or a version in the workflow, is seen only by:

  • the person who started it, and its named contributors;
  • the approvers of its current stage, and the people who decided its earlier stages;
  • HR administrators and the JD administrator.

Archived job descriptions

An archived job description has been taken off the published list. Its versions are kept until their purge date, seven years by default. Published versions and the audit trail are always kept.

Was this helpful?