Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/chamals3n4/OpenATS/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Job Management is the foundation of your hiring workflow in OpenATS. Create detailed job postings with comprehensive descriptions, salary information, and required skills to attract the right candidates.
Jobs can exist in multiple states: draft, published, inactive, closed, or archived. Only published jobs are visible to candidates.

Creating a Job Posting

Basic Information

Every job posting requires the following core details:

Job Title

The position name that candidates will see (e.g., “Senior Full-Stack Engineer”)

Department

Associate the job with a specific department in your organization

Employment Type

Choose from: Full-time, Part-time, Contract, Internship, or Freelance(Values: full_time, part_time, contract, internship, freelance)

Location

Specify the job location or indicate if it’s remote

Job Description

Craft a compelling job description that includes:
  • Role overview and key responsibilities
  • Required qualifications and experience
  • Company culture and benefits
  • Growth opportunities
Use formatting to make your job description scannable. Candidates appreciate bullet points and clear section headers.

Skills & Requirements

Add relevant skills to help:
  • Filter and match candidates automatically
  • Power CV analysis and scoring
  • Appear in candidate searches
Simply enter skills one at a time (e.g., “React”, “TypeScript”, “PostgreSQL”).

Compensation Configuration

OpenATS supports flexible salary configurations to match your compensation strategy:

Fixed Salary

Specify an exact compensation amount:
1

Select 'Fixed' salary type

Choose this when you have a specific salary in mind
2

Set currency

Use ISO 4217 currency codes (USD, EUR, GBP, etc.)
3

Choose pay frequency

Select: Hourly, Daily, Weekly, Monthly, or Yearly
4

Enter salary amount

Input the exact compensation figure

Salary Range

Provide a minimum and maximum salary band:
1

Select 'Range' salary type

Use this for flexible compensation discussions
2

Set currency and frequency

Same as fixed salary configuration
3

Define min and max

Enter both values (max must be greater than min)
Salary information can be displayed on the public job posting or kept internal for recruiter reference only.

Job Status Lifecycle

Draft

Jobs start in draft mode, allowing you to:
  • Build out the complete job description
  • Configure pipeline stages
  • Add custom application questions
  • Review with stakeholders

Published

When ready, publish the job to:
  • Make it visible on your careers page
  • Accept candidate applications
  • Begin receiving submissions
Publishing a job activates its unique slug URL. Ensure all details are correct before publishing.

Managing Active Jobs

Set status to Inactive to temporarily stop accepting new applications while keeping the job listing visible.

Accessing Jobs

By ID

Every job has a unique numeric identifier used internally in the system.

By Slug

Jobs also have a URL-friendly slug (e.g., senior-full-stack-engineer-2024) that:
  • Appears in the public job posting URL
  • Makes links more readable and shareable
  • Is automatically generated from the job title
https://jobs.yourcompany.com/careers/senior-full-stack-engineer-2024

Deletion & Restrictions

You cannot delete a job that has candidates. Instead, close or archive it to preserve the candidate history and maintain data integrity.
This restriction ensures:
  • Candidate data is never orphaned
  • Historical records remain intact
  • Compliance requirements are met

Best Practices

Use gender-neutral language and focus on actual requirements rather than “nice-to-haves” that may discourage qualified candidates.
Add 5-10 core skills rather than an exhaustive list. This improves CV matching accuracy.
Close or pause jobs as soon as the position is filled to avoid collecting applications you won’t review.
Proper department categorization helps with reporting and hiring team assignments.

Next Steps

Configure Pipeline Stages

Set up your hiring workflow stages

Add Custom Questions

Create application screening questions

Build Hiring Teams

Assign team members to jobs

Start Tracking Candidates

Begin accepting applications

Build docs developers (and LLMs) love