Connect Greenhouse to WordPress

Greenhouse Jobs for WordPress needs WordPress 6.0 and PHP 7.4 or newer. It connects one Greenhouse job board to one site.

1. Install the plugin

1. Download the plugin ZIP from your account on portal.w4dev.com.
2. In wp-admin, go to Plugins → Add New Plugin → Upload Plugin, choose the ZIP and click Install Now.
3. Click Activate.

A Greenhouse menu appears, with Jobs, Departments, Locations, Employment types, Settings, Submissions and Google Indexing.

2. Turn on updates with your license key

Once licensing is available, a Greenhouse → License screen appears. Paste the key from your purchase email there. The key turns on plugin updates inside wp-admin. Your jobs are listed with or without it.

3. Connect Greenhouse to WordPress with your board token

Go to Greenhouse → Settings and fill in Board token. The board token is the last part of your public Greenhouse job board address:

• https://job-boards.greenhouse.io/acme: the board token is acme;
• older boards, https://boards.greenhouse.io/acme: the board token is acme.

You can paste the full address instead; the plugin keeps only the token. If your board is embedded on your own careers page, the token is the for= value in Greenhouse’s embed code, and you can paste the embed script’s address as it is.

The board token is public. It is not an API key, and listing jobs needs no key at all.

Click Save Changes. The plugin checks the token with Greenhouse and starts the first import within about a minute. The jobs published on your Greenhouse job board then appear at https://yoursite.com/jobs/, each on its own page. Internal-only and unpublished job posts are not listed.

If Greenhouse reports no board with that token, the previous value is kept and the screen says so. Check the spelling against your job board address. If Greenhouse can’t be reached at that moment, the token is saved anyway and the import reports any problem under Greenhouse → Settings → Tools.

To import straight away or check the connection, use the tools at the bottom of the screen.

4. Optional: add a Job Board API key

Without a key, each job’s Apply on Greenhouse button sends candidates to the job’s Greenhouse posting. Everything else works the same. Add a key to take applications on your own site: with Applications left on Automatic, the form turns on as soon as the key is saved.

A Greenhouse admin creates the key in Greenhouse. No partner approval is needed.

1. In Greenhouse, go to Configure → Dev Center → API Credential Management.
2. Click Create new API key.
3. Choose the API type Job Board and give it a description you will recognise, such as “WordPress site”.
4. Create the key and copy it when Greenhouse shows it.

Use a Job Board key. A Harvest key is not needed; don’t use one here.

In WordPress, paste the key into Job Board API key on Greenhouse → Settings and save. Job pages now show the application form.

The key is stored as an option on your own server. Once saved, the field shows a row of dots, and the key is never printed into a page or sent to visitors’ browsers. To replace it, paste a new one and save. To delete it, tick Remove and save.

How the form works, and what happens if Greenhouse rejects the key: Greenhouse application form.

Next steps

• Every setting explained
• Put jobs on any page with a shortcode or block
• Match job pages to your theme