---
title: "Connect Workable to WordPress"
description: "Install the plugin and connect Workable to WordPress with your subdomain; jobs sync to /jobs/. A token adds on-site applications."
source: https://workable.w4dev.com/docs/installation/
---

Workable Jobs for WordPress needs WordPress 6.0 and PHP 7.4 or newer. It connects one Workable
account 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 **Workable** menu appears, with **Jobs**, **Departments**, **Locations**, **Employment types**,
**Settings**, **Submissions**, **Google Indexing** and **License**.

## 2. Turn on updates with your license key

Go to **Workable → License** and paste the key from your purchase email. The key turns on
plugin updates inside wp-admin. Your jobs are listed with or without it.

## 3. Connect Workable to WordPress with your subdomain

Go to **Workable → Settings** and fill in **Account subdomain**. Your Workable subdomain is the
account name in either of these addresses:

- your Workable login, `https://acme.workable.com`: the subdomain is `acme`;
- your careers page, `https://apply.workable.com/acme/`: the subdomain is `acme`.

You can paste either full address; the plugin keeps only the subdomain.

Workable's job widget asks for a 6-digit account ID. This field takes the subdomain, not that
number.

Click **Save Changes**. The plugin checks the subdomain with Workable and starts the first
import within about a minute. Your jobs then appear at `https://yoursite.com/jobs/`, each on
its own page.

If Workable reports no account at that subdomain, the previous value is kept and the screen
says so. Check the spelling against your careers page address.

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 Workable API token

Without a token, each job's apply button sends candidates to Workable's hosted form. Everything
else works the same. Add a token to take applications on your own site.

In Workable (you need to be an Admin):

1. Click your profile icon, then go to **Settings → Integrations → Apps**.
2. Under **API Access Tokens**, click **Generate API token**.
3. Name it something you will recognise, such as "WordPress site", and pick an expiration.
4. Tick the two scopes the plugin needs:
   - `r_jobs`, to read each job's application form and questions;
   - `w_candidates`, to create a candidate when someone applies.
5. Click **Generate token** and copy it. Workable shows it only once.

API tokens are available on every Workable plan.

In WordPress, paste the token into **API access token** on **Workable → Settings** and save. Job
pages now show the application form.

The token is stored as an option on your own server. Once saved, the field shows a row of dots,
and the token 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 Workable rejects the token:
[Workable 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/)