Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub


Loads job openings from Workable into Gatsby.js

This repository is a fork of tumblbug/gatsby-source-workable


npm install gatsby-source-workable


To use this source you need to supply a Workable API key and your Workable subdomain. You can create a Workable API key by logging into Workable and going to Integrations > Access Token. You can see your subdomain by logging into your Workable backend and checking the URL, e.g. mycompany.workable.com.

Next, edit gatsby-config.js to use the plugin:

    plugins: [
      resolve: 'gatsby-source-workable',
      options: {
        subdomain: 'mycompany',
        apiKey: 'abc-123',
        fetchJobDetails: true // optional

By default, gatsby-source-workable will only retrieve job openings that are published. To change this behavior, you can also supply an optional queryParams parameter inside of options. Possible query parameters are detailed in Workable’s API Documentation.

If you need more detailed information for each job opening you can also enable fetchJobDetails in options. This will make one additional API call per opening, providing all the information detailed here.


You can query the nodes created by the plugin as follows:

    allWorkableJob {
        edges {
            node {

Detailed field descriptions are also available on Workable’s API Documentation.



© 2023 Gatsby, Inc.