---
title: "Connect Greenhouse to WordPress"
description: "Install the plugin and connect Greenhouse to WordPress with your board token; jobs sync to /jobs/. A Job Board API key adds on-site applications."
source: https://greenhouse.w4dev.com/docs/installation/
---

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](/docs/settings/#tools-test-import-and-clear-cache).

## 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.
<!-- VERIFY: the Greenhouse user permission needed to create API keys (Greenhouse-side; the plugin only says "a Greenhouse admin") -->

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](/docs/on-site-applications/).

## Next steps

- [Every setting explained](/docs/settings/)
- [Put jobs on any page with a shortcode or block](/docs/shortcodes-and-blocks/)
- [Match job pages to your theme](/docs/templates/)