Customize the Job Posting Form

Job form settings control which fields appear on your board's posting form, whether they are optional or required, and which options are available to employers. The configuration applies to every posting surface on your board — your own operator form, the public submission form, and the employer forms.

Configure the job form

1. Go to Board settings in the sidebar
2. Click Job form
3. For each field, toggle visibility using the Off / On / Required control
4. To restrict the allowed options for a field, open the dropdown and select the values you want
5. Click outside the dropdown to save

Changes are saved instantly. The public board's filter facets update to match; a facet reduced to one allowed option is hidden automatically. To rename field labels, use the Website builder on the Post a job page.

Fields

Each field is a separate card on the settings page:

• Employment type: Limit the types available on the form. Selecting one removes the field and implies that type for every job.
• Seniority: Show or hide the seniority field, mark it required, and restrict which levels are available.
• Work arrangement: Limit accepted arrangements. Selecting one removes the field and implies that arrangement for every job.
• Location: Restrict office locations to specific countries.
• Salary: Show or hide the salary field, mark it required, set minimum and maximum bounds, and restrict accepted currencies.
• Visa sponsorship: Show or hide the sponsorship question.

Custom fields

Beyond the built-in fields, you can add your own. Open the Custom fields section at the bottom of the Job form settings page and click Add field.

Each field has a label, a type, and an optional required toggle. Pick from six types:

• Short text: a single line, for answers such as a security clearance.
• Long text: a paragraph, for a longer description.
• Dropdown (single choice): one value from a list of options you define.
• Checkboxes (multiple choice): any number of values from a list you define.
• Yes / No toggle: a simple flag.
• Number: a numeric value, with optional minimum and maximum.

Drag the handle to reorder fields; the order you set is the order they appear on the form and the public job page. You can rename a field label or an option label at any time without losing answers already submitted. The field's internal key is fixed once you save, so stored answers stay linked.

Custom fields are captured on every posting surface (your operator form, the public submission form, and the employer forms) and validated the same way. Answers are shown on the public job page in an Additional details section, below the job description. The section heading and the Yes / No wording can be translated per board in the Website builder. Custom fields are display only for now: they do not feed search filters or structured data.

To remove a field, open its menu and choose Delete. You can keep submitted answers, which lets you re-adopt them later by re-creating a field with the same key, or delete them.

A board can have up to 20 custom fields, each select can have up to 50 options, and labels can be up to 60 characters.

Read the configuration via the API

Headless clients can read the board's job form configuration before rendering their own posting form.

1
GET /v1/settings/job-form

The endpoint returns the stored configuration object, or an empty object when no configuration has been saved. The object includes your custom field definitions (each with its key, label, type, and options), so a headless client can render them too. Authenticate with an API key, user session, or OAuth token. See the API reference for the full schema.