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 - the job’s custom_fields holds the raw stored values (a number stays 1500), and custom_fields_labelled holds the same answers as the job page shows them ($1500 per year, a formatted date, a choice’s label), keyed the same way.

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.

Resume field answers show on the resume page under Additional details, for people who may open that resume.

Setting Who sees it
Public Everyone who may open the resume. The default. Also printed in the resume PDF.
Employer only The candidate, anyone who may view resumes (employers) and site staff. Never in the PDF.
Admin only Site staff only. Never in the PDF.

Before 1.8.4 resume answers showed only in the candidate’s own forms. If a resume field holds something private, such as expected salary, set it to Employer only or Admin only. Fields added with the wcb_resume_form_fields filter have no visibility setting, so they are not shown on the resume page.

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.