# Jobs Overview The Jobs module is for advertising open positions at your school — teaching, support, casual relief, executive — to the right audience. PortalHQ supports two modes: **internal** postings visible only to staff, and **public** postings visible on the school's website careers page (embedded via the Jobs API). ## What it covers - **Job postings** — the role itself, with description, requirements, salary range, application deadline. - **Role types** — categorisation (teaching, administration, IT, maintenance, etc.) used for filtering. - **Applications** — submitted applications, stored against the relevant posting. ## Who uses what | Role | Activity | |---|---| | **HR / Business Manager** | Creates and posts jobs, configures role types, reviews applications. | | **Hiring managers** | Provides job descriptions and selection criteria. | | **Staff** | See internal postings on the staff dashboard — useful for internal mobility. | | **External applicants** | See public postings on the school website careers page; submit applications. | ## Internal vs. external postings Each job posting is either: - **Internal** — visible only to logged-in staff via the staff dashboard. Used for internal mobility, acting positions, leadership development opportunities. - **External** — visible publicly on the school careers page. Used for genuine external hires. A single job can be posted internally first (e.g. give internal staff a week to apply) before switching to external posting. ## The lifecycle 1. **Create** the job posting — see [Creating and managing job postings](/portalhq/articles/creating-and-managing-job-postings/). 2. **Post it** — internal, external, or both. 3. **Applications come in** — submitted via the public-facing application form. 4. **Review applications** — see [Role types and reviewing applications](/portalhq/articles/role-types-and-reviewing-applications/). 5. **Close** the posting once the deadline passes or the role is filled. ## Where the public listings live External jobs are exposed via the Jobs API (`/jobs/api/listing/`) for embedding into the school website. Your website team uses the API to render the careers page; PortalHQ is the source of truth. The job count endpoint (`/jobs/job-count/`) returns the number of currently open postings — useful for displaying *3 open positions* on the homepage. ## Where to start - Posting your first job: [Creating and managing job postings](/portalhq/articles/creating-and-managing-job-postings/). - Setting up role categories: [Role types and reviewing applications](/portalhq/articles/role-types-and-reviewing-applications/).