---
title: "Shortcodes and blocks"
description: "Reference for the wkjb_jobs, wkjb_filters, wkjb_job and wkjb_apply shortcodes and matching blocks, with every attribute for the job list and filters."
source: https://workable.w4dev.com/docs/shortcodes-and-blocks/
---

You get a job list at `/jobs/` without doing anything. Use these shortcodes and blocks to put
jobs anywhere else: a careers page you designed yourself, a sidebar, a landing page.

<figure class="ak-shot">
  <img src="/screenshots/job-list.webp" alt="Job list with department and location filters, rendered by Workable Jobs for WordPress" width="1200" height="844" loading="lazy" decoding="async" />
  <figcaption>The job list, rendered by [wkjb_jobs] or the Job List block.</figcaption>
</figure>

In the block editor, the same four pieces are blocks: search the inserter for "Job" to find
**Job List**, **Job Filters**, **Single Job** and **Job Application Form**. Each block shows a
live preview of what it will render. **Single Job** and **Job Application Form** take the
Workable job ID in the block settings sidebar; **Job List** lets you set the number of jobs per
page and a department or location there. Every other attribute below keeps its default in a
block; use the shortcode when you need one of those.

| Shortcode | What it shows | Block name |
|---|---|---|
| `[wkjb_jobs]` | The job list | `wkjb/job-list` |
| `[wkjb_filters]` | The search and filter form | `wkjb/job-filters` |
| `[wkjb_job]` | One job | `wkjb/single-job` |
| `[wkjb_apply]` | The apply area for one job | `wkjb/application-form` |

Yes/no attributes take `yes` or `no`.

## `[wkjb_jobs]` — job list

| Attribute | Default | What it does |
|---|---|---|
| `per_page` | `20` | Jobs per page. |
| `columns` | `1` | Grid columns, 1 to 4. |
| `department` | empty | Show only one department. Takes the department name, for example `department="Engineering"`. |
| `office` | empty | Show only one location. Takes the location name as shown in the filter dropdown. |
| `search` | empty | Show only jobs matching this text in the title, location, description or department. |
| `show_filters` | `no` | Show the search and filter form above the list. |
| `show_count` | `yes` | Show "Showing 1–20 of 74 open positions". |
| `show_pagination` | `yes` | Show page links when there is more than one page. |
| `show_location` | `yes` | Show each job's location. |
| `show_department` | `yes` | Show each job's department. |
| `show_date` | `no` | Show each job's posting date. |
| `show_excerpt` | `no` | Show a short excerpt of each job's description. |
| `group_by` | empty | `department` or `office` groups the list under headings. |
| `board` | empty | Leave empty. 1.0 connects one Workable account. |

Jobs are sorted newest first.

Examples:

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

When `department`, `office` or `search` is set on the shortcode, it wins over what the visitor
picks in the filter form.

## `[wkjb_filters]` — search and filter form

A standalone filter form, for when you want the form somewhere other than directly above the
list, such as a sidebar.

| Attribute | Default | What it does |
|---|---|---|
| `show_search` | `yes` | Show the search box. |
| `show_department` | `yes` | Show the department dropdown. |
| `show_office` | `yes` | Show the location dropdown. |
| `board` | empty | Leave empty. |

The dropdowns list only departments and locations that have an open job. The form submits to
the page it sits on, using the query parameters `wkjb_search`, `wkjb_department` and
`wkjb_office`, so put a `[wkjb_jobs]` list on the same page. Pagination uses `wkjb_page`.

## `[wkjb_job]` — a single job

| Attribute | Default | What it does |
|---|---|---|
| `id` | empty | The job's Workable shortcode, the 10-character code at the end of its address, such as `id="B4E3109622"`. Case does not matter. Empty uses the job being viewed. |
| `show_title` | `no` | Show the job title as a heading. |
| `show_meta` | `yes` | Show department, location, employment type, remote and posting date. |
| `show_apply` | `yes` | Show the apply area: the on-site form or the **Apply on Workable** button. |
| `board` | empty | Leave empty. |

You can find a job's shortcode at the end of its address on your site, for example
`/jobs/branch-manager-b4e3109622/`, or in the job's link inside Workable.

## `[wkjb_apply]` — the apply area on its own

| Attribute | Default | What it does |
|---|---|---|
| `id` | empty | The job's shortcode. Empty uses the job being viewed. |
| `board` | empty | Leave empty. |

It shows the on-site application form when applications are taken on your site, and the **Apply
on Workable** button otherwise. See [On-site applications](/docs/on-site-applications/).

## Styles

The plugin's stylesheet loads on the jobs pages and on any page whose content contains a
`[wkjb_` shortcode or a `wkjb/` block. If you print a shortcode from a theme template or a page
builder, the plugin may not detect it. Force the stylesheet on with:

```php
add_filter( 'wkjb_enqueue_frontend_assets', '__return_true' );
```