Greenhouse jobs shortcode and blocks

Your jobs already have a list at /jobs/, an address you can change in the settings. Use these to show them anywhere else, such as a careers page you designed or a landing page.

Which Greenhouse jobs shortcode or block to use

In the block editor, search the inserter for “Job” to find Job List, Job Filters, Single Job, Job Application Form, Job Details, Job Sharing, Related Jobs and Job Archive Breadcrumbs. Each renders exactly what its shortcode renders. Job List and Job Filters show a live preview. The five blocks that show one job preview once a job ID is set; left blank, they show a placeholder and render the job being viewed. Job Archive Breadcrumbs has no settings and shows only on job archive pages.

The sidebar holds each block’s settings:

In a single job template, leave a one-job block’s ID blank; set one to pin a job on any page. Attributes without a sidebar setting, such as search or function, keep their default in a block; use the shortcode for those.

On block themes with WordPress 6.7 or newer, the plugin’s own job page templates are built from these blocks. See block templates.

Yes/no attributes take yes or no.

[ghjb_jobs]: the job list

Jobs are sorted newest first. An attribute that picks jobs, such as department or search, wins over what the visitor picks. Its filter is left out of the list’s own form, and out of a Job Filters block or [ghjb_filters] on the same page.

Developers can change the heading level of every list with the ghjb_job_list_heading_level filter, which receives the level and the list’s attributes.

[ghjb_jobs show_filters="yes"]
[ghjb_jobs department="Engineering" per_page="5" show_count="no" show_pagination="no"]
[ghjb_jobs columns="2" group_by="department" show_excerpt="yes"]

[ghjb_filters]: filter by department or location

A standalone search and filter form, for a sidebar or anywhere other than directly above the list.

[ghjb_filters filters="search,location,type"]

Dropdowns list only terms with an open job, and leave out hidden terms. Put a [ghjb_jobs] list on the same page: the form filters it in place, and updates the address so the filtered list can be shared. Typing searches half a second after the visitor stops, from the second character; Enter searches for whatever is in the box. Without JavaScript the form submits normally, with the same result.

Each filter is a query parameter. ghjb_search holds the search text; the others hold a term slug: ghjb_department, ghjb_location, ghjb_type, ghjb_workplace, ghjb_function, ghjb_industry, ghjb_experience and ghjb_education. So /jobs/?ghjb_location=ireland&ghjb_type=full-time links straight to a filtered list. Pagination uses ghjb_page, or /page/2/ on the jobs page and its archives. With more than one list on a page, each pages on its own: the first uses ghjb_page, the second ghjb_page_2, the third ghjb_page_3, and so on.

[ghjb_job]: one job

A job’s ID is at the end of its address on your site, for example /jobs/senior-designer-4012345/, and at the end of its link on your Greenhouse job board, such as https://job-boards.greenhouse.io/yourcompany/jobs/4012345.

[ghjb_apply]: the apply area on its own

It shows the on-site application form when applications are taken on your site, and the Apply on Greenhouse button otherwise. See Greenhouse application form.

[ghjb_job_meta]: job details

The details box on its own, for a custom job layout.

Empty details are left out. Function, industry, experience and education fill only when your board has matching custom fields.

Pay range shows the pay ranges Greenhouse publishes with the job, one line each, such as “146,500 – 198,300 USD per year”. The period shows only when the range names one. When a job has several ranges, each line starts with the range’s title, usually a location or pay zone. Turning off Pay ranges under Greenhouse → Settings → Display hides the row on every job, whatever show_pay says.

[ghjb_job_meta show_date="no"]

[ghjb_job_sharing]: share links

Links to share the job on LinkedIn, X, Facebook and by email, plus a Copy link button. They are plain links, so no script from those networks loads on your page. The copy button appears only where the browser can copy.

Developers can add, remove or reorder networks with the ghjb_share_links filter.

[ghjb_related_jobs]: related jobs

A short list of other open jobs, to keep candidates browsing. Jobs in the same department come first, then jobs in the same region, newest first. The job being viewed is never listed, and nothing shows when no job matches.

The job page templates include Related Jobs. Developers can hide it there, and wherever the Related Jobs block is placed, by returning false from the ghjb_show_related_jobs filter.

Load the styles on custom layouts

The plugin’s stylesheet loads on the jobs pages and on any page whose content holds a [ghjb_ shortcode or a ghjb/ block. A shortcode printed from a theme template or a page builder may not be detected. Force the stylesheet on with:

add_filter( 'ghjb_enqueue_frontend_assets', '__return_true' );