Skip to content

Custom Field Builder - overview

WP Career Board overviewFree + ProGet WP Career Board →

You can add your own fields to jobs, company profiles, candidate profiles, resumes and job applications, without code. For example, add “Remote policy” to every job, or a screening question that every applicant must answer.

  • Add fields to job listings (Remote policy, Visa sponsorship, Tech stack).
  • Add fields to company profiles (Funding stage, Glassdoor rating).
  • Add fields to candidate profiles (Notice period, Portfolio URL).
  • Add fields to resumes (Availability, Certifications).
  • Add application questions that applicants answer when they apply.
  • Group fields into sections with a heading.
  • Mark fields required, and choose who can see them on the job page.
  • Show job fields on the job page, offer them as filters on the job listing, and send some of them to Google for Jobs.

Open the Field Builder at Career Board > Settings > Field Builder.

Each field group is defined once and applies to every board. There is no board selector in the Field Builder.

For Job fields and Application questions, each group has a Hide on boards control. A group shows on every board by default. Add a board to the control to hide that group on that board. Company, candidate and resume fields have no per-board control.

  • Forms - the fields appear on the matching form: the job form for job fields, the company profile in the employer dashboard for company fields, the candidate dashboard for candidate fields, the Resume Form (Quick Profile) block for resume fields, and the apply form for application questions. Required application questions block the application until they are answered.
  • Job page - answered job fields show under the description in an Additional details section.
  • Job listing filters - a Dropdown, Radio, Multi-select or Checkbox job field with Filterable on shows as a filter group in the job listing sidebar. Only Public fields can be filters. The filter uses the meta_<field key> query parameter.
  • Google for Jobs - pick a Google for Jobs property when you add a job field, and its value is sent in the job’s structured data. See Creating custom fields.
  • Job REST response - custom job field values are included in the job’s custom_fields.

This applies to the job page and the job REST response.

Setting Who sees it
Public Everyone, including guests. The default.
Employer only The job’s author and site staff.
Admin only Site staff only.

Field groups reach each form through these filters: wcb_job_form_fields, wcb_company_form_fields, wcb_candidate_form_fields, wcb_resume_form_fields and wcb_application_form_fields_groups.

Add-ons can listen to wcbp_field_group_saved, wcbp_field_group_deleted, wcbp_field_definition_saved, wcbp_field_definition_deleted and wcbp_field_value_saved.

Field definitions are cached for 5 minutes, and the cache clears when you save or delete a group or field.