Creating custom fields

You can create field groups and fields for jobs, companies, candidates, resumes and applications, and choose where each one shows.

Open the Field Builder

Go to Career Board > Settings and open the Field Builder tab.

The tabs are Job fields, Company fields, Candidate fields, Resume fields and Application questions. The note “These fields are global - they apply across all boards” shows on the tabs that have no per-board control.

Create a group

1. Choose a tab.
2. Click Add group.
3. Enter a Group label, for example “Compensation”.
4. Click Create group.

Use Rename to change the label and Delete group to remove the group and its fields.

Hide a group on some boards

On the Job fields and Application questions tabs, open a group and use Hide on boards. Add the boards where the group should not show. The group shows on every other board.

Add a field

1. Open the group.
2. Click Add field.
3. Fill in the form:

Setting	What it does
Label	The name shown on the form and the job page.
Field type	One of 17 types. See Field types reference.
Visibility	Public, Employer only or Admin only.
Required	Marks the field as required. Application questions block the application until answered.
Google for Jobs property	Job fields only, when adding. Sends the value to Google.
Filterable	Job fields of type Dropdown, Radio, Multi-select or Checkbox. Adds a filter to the job listing (public fields only).
Choices	For Dropdown, Multi-select, Radio and Checkbox types. Add at least one choice.

4. Click Add field.

The field key is created for you and never changes, so stored values stay linked when you rename the field. It starts with wcbf_, followed by the Google property name if you picked one, or a generated ID.

Google for Jobs property

When you add a job field, pick one of these properties to send its value in the job’s structured data:

Field	Google property
Benefits	jobBenefits
Qualifications	qualifications
Responsibilities	responsibilities
Skills	skills
Education	educationRequirements
Experience	experienceRequirements
Industry	industry
Work hours	workHours

One field can feed each property. If another field already does, saving shows “Another field already feeds this Google property. Choose a different one, or none.” The property is fixed after the field is created. Only public fields are sent to Google. A checkbox field is not sent.

Application questions

Fields on the Application questions tab appear on the apply form of every job on a board that does not hide the group. Applicants answer them when they apply, and required questions must be answered.

Edit, reorder and delete

• Edit changes the label, type, visibility, required state, choices and Filterable. The field key never changes.
• Move up and Move down reorder fields inside a group.
• Delete removes the field definition. Values already saved on jobs and applications are not removed.

Where fields appear

• Job fields - the job form, the job page (“Additional details”), the listing filters and the job REST response.
• Company fields - the company profile in the employer dashboard.
• Candidate fields - the candidate dashboard profile.
• Resume fields - the Resume Form (Quick Profile) block.
• Application questions - the apply form.

REST API

The admin screen uses these routes. All require the wcb/manage-boards ability.

Method	Route	Purpose
GET	/wcb/v1/fields/groups	List groups (board_id, entity_type)
POST	/wcb/v1/fields/groups	Create a group
PUT	/wcb/v1/fields/groups/{id}	Update a group
DELETE	/wcb/v1/fields/groups/{id}	Delete a group
GET	/wcb/v1/fields/groups/{group_id}/fields	List a group’s fields
POST	/wcb/v1/fields/groups/{group_id}/fields	Add a field. A duplicate field_key returns 409.
PUT	/wcb/v1/fields/{id}	Update a field
DELETE	/wcb/v1/fields/{id}	Delete a field
POST	/wcb/v1/fields/reorder	Reorder fields

Groups are stored under board 0, so pass board_id=0.