> ## Documentation Index
> Fetch the complete documentation index at: https://docs.needle.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Jobs

> Set up a job: description, hiring criteria, stages, and application questions.

Everything in Needle starts with a job. Creating one gives you a pipeline, a page on your careers site, and an agent briefed on the role.

## Create a job

Go to **Jobs → New job** in the app, or describe the role to the agent in Slack ("open a senior backend engineer role in Berlin") and it drafts the description and pipeline for you to edit.

## What to fill in

* **Description** — shown on the career page, and used by the agent whenever it writes about the role.
* **Hiring criteria** — the must-haves and nice-to-haves. This is the most important field; see below.
* **Pipeline stages** — the defaults work to start. Rename, add, or remove stages to match your process.
* **Application questions** — asked on the application form, and factored into screening.

## Writing good criteria

Criteria are used everywhere: applicants are screened against them and sourced candidates are scored on them. Write them in plain English, one criterion per line, and be concrete:

* "5+ years of backend experience" beats "strong engineer"
* "has worked at an early-stage startup" beats "startup mindset"
* "based in Europe" beats "location fit"

When the role changes, update the criteria — new applicants and candidates are evaluated against the current version.

## Publish

Publishing puts the job on your career page and opens it for applications. Screening starts with the first applicant. Unpublished jobs still work fully inside Needle — for sourcing, for example — they're just not public.