Creating your first position
A complete walkthrough of creating, configuring, and publishing a position.
This guide expands on the Quick start by covering every field and option available when creating a position.
Creating the position
Click New position from the Positions page. Fill in the form:
| Field | Required | Notes |
|---|---|---|
| Title | Yes | The job title shown on your careers page and in candidate communications |
| Department | No | Select from your org's departments. Helps with filtering and careers page navigation |
| Location | No | Free text. Use "Remote" for remote positions or a city name for on-site |
| Employment type | No | Full-time, part-time, contract, or internship |
| Description | No | Rich text description shown on the careers page. Supports formatting, lists, and links |
Click Create. The position starts in Draft status, invisible to candidates.
Adding compensation details
Open the position and scroll to the compensation section. You can specify:
- Salary range - minimum and maximum values
- Currency - USD, EUR, GBP, and other common currencies
- Pay unit - per year, per month, or per hour
Compensation details are shown on the careers page if filled in. Leaving them blank hides the section entirely.
Customizing the application form
Go to the Form tab. Every position starts with a copy of your org's default form template. You can:
- Add fields from your field library (or create new ones)
- Remove fields you don't need for this role
- Reorder fields by dragging them
- Toggle fields between required and optional
- Set fields to half-width so two fields sit side by side
Field types
| Type | Use case | Example |
|---|---|---|
| Short text | Single-line input | Current company |
| Long text | Multi-line textarea | Cover letter |
| Email with validation | Work email | |
| Phone | Phone with country picker and E.164 validation | Mobile number |
| URL | URL with optional regex validation | Portfolio, LinkedIn, GitHub |
| Location | City autocomplete via OpenStreetMap | Current city |
| Date | Date picker | Earliest start date |
| Number | Numeric input | Years of experience |
| Select | Single-choice dropdown | Preferred office location |
| Boolean | Yes/no toggle | Requires visa sponsorship |
| File | File upload (PDF, DOC, images) | Resume, work samples |
Publishing
When you're ready to accept applications, change the position status to Open. This makes it visible on your careers page and the direct application URL.
Position status lifecycle:
- Draft → not visible, no applications accepted
- Open → live on careers page, accepting applications
- Closed → visible but not accepting new applications
- Archived → removed from careers page entirely