Pro blocks reference
You can add Pro features to any page with blocks: a job map, resume search, a candidate directory, credit balance, job alerts and more. This page lists each Pro block, the settings it has and where to put it.
All Pro blocks are in the Widgets category. Most of them are in the block inserter. Four are not, because Career Board places them for you:
- Application Kanban - on the Hiring Pipeline page.
- Credit Balance - as the Credits tab of the Employer Dashboard.
- Resume Builder - inside the Candidate Dashboard.
- My Applications - not in the inserter. Add it with its shortcode.
Shortcodes
Section titled “Shortcodes”Every Pro block also has a shortcode, so you can use it in a page builder or the classic editor. Use the block attributes below as the shortcode attributes, for example [wcbp_resume_archive perPage="12"].
| Block | Shortcode |
|---|---|
| AI Chat Search | [wcbp_ai_chat_search] |
| Application Kanban | [wcbp_application_kanban] |
| Credit Balance | [wcbp_credit_balance] |
| Featured Candidates | [wcbp_featured_candidates] |
| Featured Companies | [wcbp_featured_companies] |
| Job Alerts | [wcbp_job_alerts] |
| Job Map | [wcbp_job_map] |
| My Applications | [wcbp_my_applications] |
| Open to Work | [wcbp_open_to_work] |
| Find Resumes | [wcbp_resume_archive] |
| Resume Builder | [wcbp_resume_builder] |
| Resume Form (Single-Page) | [wcbp_resume_form] |
| Resume Form (Quick Profile) | [wcbp_resume_form_simple] |
| Resume Map | [wcbp_resume_map] |
| Resume Search Hero | [wcbp_resume_search_hero] |
| Resume Single | [wcbp_resume_single] |
The experience filter of the Resume Search Hero can be switched off only in the block editor.
Where to add each block
Section titled “Where to add each block”| Block | Recommended page |
|---|---|
| AI Chat Search | Jobs page, in place of or above the standard Job Search block |
| Application Kanban | The Hiring Pipeline page (created for you) |
| Credit Balance | Shown in the Employer Dashboard Credits tab |
| Featured Candidates | Homepage or company page sidebar |
| Featured Companies | Homepage or jobs page sidebar |
| Job Alerts | Jobs page, below or beside the Job Listings block |
| Job Map | Jobs page, alongside Job Listings and Job Filters |
| My Applications | A candidate page, through its shortcode |
| Open to Work | Homepage sidebar or employer-facing pages |
| Find Resumes | The Find Candidates page (created for you) |
| Resume Builder | Shown inside the Candidate Dashboard |
| Resume Form (Single-Page) | A dedicated resume page, for a long one-screen form instead of the section-by-section builder |
| Resume Form (Quick Profile) | Sidebars, modals, partner pages and onboarding flows |
| Resume Map | Find Candidates page, alongside Find Resumes |
| Resume Search Hero | Find Candidates page, above Find Resumes |
| Resume Single | Applied to single resume pages automatically |
Add a Pro block
Section titled “Add a Pro block”- Open a page in the WordPress editor.
- Click + to add a block.
- Search for the block name, for example “Job Map”.
- Click it to insert it.
Who sees the candidate blocks
Section titled “Who sees the candidate blocks”Find Resumes, Resume Search Hero, Resume Map, Featured Candidates and Open to Work follow the Candidate directory visibility setting under Career Board > Settings > Resumes. If a visitor is not allowed to browse candidates, these blocks show nothing.
Block details
Section titled “Block details”AI Chat Search (wcb/ai-chat-search)
Section titled “AI Chat Search (wcb/ai-chat-search)”You can let signed-in members describe the job they want in their own words, such as “remote product manager role with equity”, and get up to 10 matching jobs.
| Attribute | Type | Default | Description |
|---|---|---|---|
placeholder |
string | “Describe your ideal job…” | Input placeholder text |
Before it works you need an OpenAI or Ollama provider set for matching under Career Board > Settings > AI Settings. Until a provider is set, administrators see a notice and other visitors see nothing. Visitors who are not signed in cannot run a search. See AI features.
Application Kanban (wcb/application-kanban)
Section titled “Application Kanban (wcb/application-kanban)”You can let employers move applicants between hiring stages by dragging cards on a board.
| Attribute | Type | Default | Description |
|---|---|---|---|
jobId |
integer | 0 |
The job whose pipeline the board shows |
The board opens for one job. Employers open it from the Pipeline button on their dashboard, which adds ?job=ID to the Hiring Pipeline page. With no job set, the block shows a link back to the dashboard. Only the job’s owner and administrators can see the board. See Application Pipeline.
Credit Balance (wcb/credit-balance)
Section titled “Credit Balance (wcb/credit-balance)”You can show employers their credit balance, a Buy Credits button, purchases awaiting payment, receipts and their transaction history. On the Employer Dashboard this block is the Credits tab.
| Attribute | Type | Default | Description |
|---|---|---|---|
showHistory |
boolean | true |
Show or hide the transaction history |
It shows the signed-in user’s own balance and shows nothing to signed-out visitors. What can be bought comes from your Credits settings. If nothing can be bought, the block says so instead of showing a Buy button. See Native Buy Credits checkout.
Featured Candidates (wcb/featured-candidates)
Section titled “Featured Candidates (wcb/featured-candidates)”You can highlight candidates you have marked as featured in a sidebar list.
| Attribute | Type | Default | Description |
|---|---|---|---|
count |
integer | 5 |
Number of candidates to show |
title |
string | “Featured Candidates” | Heading above the list |
showViewAll |
boolean | true |
Show a “View all” link |
viewAllUrl |
string | Find Candidates page | Where the “View all” link goes |
It lists the newest resumes that are marked featured and set to public. Each row shows the photo, name, the job title from the first experience entry, and up to 3 skills. Visitors see nothing when there are no featured candidates. Administrators see a short message.
Featured Companies (wcb/featured-companies)
Section titled “Featured Companies (wcb/featured-companies)”You can show featured companies with their open positions in a sidebar list.
| Attribute | Type | Default | Description |
|---|---|---|---|
count |
integer | 5 |
Number of companies to show |
title |
string | “Featured Companies” | Heading above the list |
showViewAll |
boolean | true |
Show a “View all” link |
viewAllUrl |
string | empty | Where the “View all” link goes. The link shows only when this is set. |
It lists companies marked featured, newest first. If no company is marked featured, it lists the newest companies instead. Each row shows the logo, name and number of open positions.
Job Alerts (wcb/job-alerts)
Section titled “Job Alerts (wcb/job-alerts)”You can let signed-in members save the job search they are looking at as an alert and choose how often to hear about new matches.
This block has no attributes.
It uses the search on the same page (Job Listings and Job Filters). When a member picks Instant, Daily or Weekly and clicks Subscribe, the alert saves the keyword, category, job type, location, salary range and remote filter they had set. The block lists their active alerts, and they can delete each one. It shows nothing to signed-out visitors. See Job Alerts.
Job Map (wcb/job-map)
Section titled “Job Map (wcb/job-map)”You can show job locations on a map that narrows to the jobs matching the Job Listings search on the same page.
| Attribute | Type | Default | Description |
|---|---|---|---|
height |
integer | 480 |
Map height in pixels |
Jobs need a location so they can be geocoded. Geocoding runs in the background after a job is saved, so a new pin can take a few minutes. Jobs without coordinates are not shown. The map always uses OpenStreetMap tiles. The Google or Mapbox setting changes only the geocoding service. The block includes a place search, a radius picker and Use my location. See Job Map.
My Applications (wcb/my-applications)
Section titled “My Applications (wcb/my-applications)”You can show a member their submitted applications as a table with Job, Status and Submitted columns. On narrow screens it becomes a list of cards.
Set employerId to show an employer the applications received for their jobs, with an Applicant column.
| Attribute | Type | Default | Description |
|---|---|---|---|
authorId |
integer | 0 |
Show another user’s applications. 0 means the signed-in user. Only administrators can view someone else’s. |
employerId |
integer | 0 |
Show the applications received for this employer’s jobs. Only that employer and administrators can see them. |
perPage |
integer | 20 |
Applications to show, up to 100 |
The block shows the newest applications up to perPage. The Status column always shows a badge, and an application with no status shows as “Submitted”.
Open to Work (wcb/open-to-work)
Section titled “Open to Work (wcb/open-to-work)”You can show candidates who are open to work in a sidebar list.
Each row shows:
- The photo from the resume, or an initial when there is none.
- The name.
- The job title from the first experience entry.
- The location from the resume, or from the first experience entry when the resume has none.
- Years of experience, counted from the earliest experience start date.
- Up to 3 skills.
| Attribute | Type | Default | Description |
|---|---|---|---|
count |
integer | 5 |
Number of candidates to show |
title |
string | “Open to Work” | Heading above the list |
showViewAll |
boolean | true |
Show a “View all” link |
viewAllUrl |
string | Find Candidates page | Where the “View all” link goes |
Only public resumes of candidates who turned on Open to new opportunities are listed. The block picks from the most recently saved ones and shuffles them on each load.
Find Resumes (wcb/resume-archive)
Section titled “Find Resumes (wcb/resume-archive)”You can give employers a searchable, paged directory of public candidate resumes.
| Attribute | Type | Default | Description |
|---|---|---|---|
perPage |
integer | 12 |
Resumes per page |
authorId |
integer | 0 |
Show only one user’s resumes. 0 shows everyone. |
Each card shows the photo, name, job title, skills and location. The keyword search matches every word against the resume title, headline, summary, location or a skill. The sidebar filters by skill (the 30 most used), experience level, location and open to work. Results sort newest or oldest first. Each change updates the page address without a full reload, so a filtered view can be shared as a link. When a Resume Search Hero is on the same page, the sidebar filters are hidden.
The Find Candidates page has this block and the Resume Search Hero already on it.
Resume Builder (wcb/resume-builder)
Section titled “Resume Builder (wcb/resume-builder)”You can let candidates build and edit their resumes section by section, including education, experience, skills and more, with a Public or Private switch.
This block has no attributes.
It needs a signed-in candidate. It opens the resume from the ?resume_id= address, or the candidate’s own resume when there is none. The Candidate Dashboard already opens it for you. See Resume Builder setup.
Resume Form, Single-Page (wcb/resume-form)
Section titled “Resume Form, Single-Page (wcb/resume-form)”You can give candidates one long form with every section open, instead of the section-by-section builder. It saves to the same resume data.
| Attribute | Type | Default | Description |
|---|---|---|---|
compact |
boolean | false |
Use a tighter, narrower layout |
It needs a signed-in candidate. See Single-Page Resume Form.
Resume Form, Quick Profile (wcb/resume-form-simple)
Section titled “Resume Form, Quick Profile (wcb/resume-form-simple)”You can give candidates a short form for the essentials: headline, summary, top skills, location, open-to-work status and a photo. It fits sidebars, modals, partner pages and onboarding flows.
| Attribute | Type | Default | Description |
|---|---|---|---|
showPhotoField |
boolean | true |
Show the photo upload field |
compact |
boolean | false |
Use a tighter, narrower layout |
It needs a signed-in candidate. It saves to the candidate’s resume, so the headline, location, skills and open-to-work status feed the Open to Work and Featured Candidates blocks. See Quick Resume Form.
Resume Map (wcb/resume-map)
Section titled “Resume Map (wcb/resume-map)”You can give employers a map of where candidates are. Clicking a pin opens a popup with a link to the candidate’s resume.
| Attribute | Type | Default | Description |
|---|---|---|---|
height |
integer | 480 |
Map height in pixels |
Only public resumes with coordinates get a pin. Pins are placed at city level (rounded to about 1 km), never at a street address. The map shows the newest 500 pins. When there are more, a line under the map reads “Showing the newest 500 of N candidates. Use the candidate search to find the rest.” It includes a radius search.
Resume Search Hero (wcb/resume-search-hero)
Section titled “Resume Search Hero (wcb/resume-search-hero)”You can put a full-width candidate search form above the directory. It sends the visitor to the Find Candidates page with the search applied.
| Attribute | Type | Default | Description |
|---|---|---|---|
layout |
string | horizontal |
horizontal or vertical |
placeholder |
string | “Search candidates…” | Search input placeholder |
buttonLabel |
string | “Search” | Search button label |
showSkillFilter |
boolean | true |
Show the skill dropdown |
showExperienceFilter |
boolean | true |
Show the experience dropdown |
showOpenToWorkFilter |
boolean | false |
Show the open-to-work option |
Resume Single (wcb/resume-single)
Section titled “Resume Single (wcb/resume-single)”You can show a candidate’s full resume on its own page. Career Board applies this block to single resume pages for you, so you usually do not add it yourself.
| Attribute | Type | Default | Description |
|---|---|---|---|
resumeId |
integer | 0 |
Show a specific resume. 0 uses the resume page being viewed. |
The block supports wide and full alignment. A private resume shows “This resume is private.” unless the viewer is its owner or is allowed to view resumes.