# gatsby-source-wordpress

> Source data from WordPress in an efficient and scalable way.

Latest version **7.17.0** (published 2026-01-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install gatsby-source-wordpress
pnpm add gatsby-source-wordpress
yarn add gatsby-source-wordpress
bun add gatsby-source-wordpress
```

## Health

**Score 45/100 (D)** — status: stable.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 7.17.0 |
| Published | 2026-01-26 |
| First published | 2017-06-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=18.0.0 <26 |
| Dependencies | 37 |
| Unpacked size | 1.3 MB |
| Known vulnerabilities | 0 (+4 in 2 direct dependencies) |
| Install scripts | no |
| Author | Tyler Barnes |
| Maintainers | pieh, kathmbeck, serhalp-netlify, mlgualtieri-gatsby |
| Keywords | gatsby, gatsby-plugin, gatsby-plugin-wordpress, gatsby-source-wordpress, wordpress |

## Links

- npm: https://www.npmjs.com/package/gatsby-source-wordpress
- Repository: https://github.com/gatsbyjs/gatsby
- Homepage: https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress#readme
- Issues: https://github.com/gatsbyjs/gatsby/issues
- npm.io page: https://npm.io/package/gatsby-source-wordpress

## Dependencies (37)

- [got](https://npm.io/package/got.md) ^11.8.6
- [atob](https://npm.io/package/atob.md) ^2.1.2
- [diff](https://npm.io/package/diff.md) ^5.1.0
- [glob](https://npm.io/package/glob.md) ^7.2.3
- [axios](https://npm.io/package/axios.md) ^1.6.4
- [chalk](https://npm.io/package/chalk.md) ^4.1.2
- [immer](https://npm.io/package/immer.md) ^9.0.21
- [sharp](https://npm.io/package/sharp.md) ^0.32.6
- [lodash](https://npm.io/package/lodash.md) ^4.17.21
- [semver](https://npm.io/package/semver.md) ^7.5.3
- [cheerio](https://npm.io/package/cheerio.md) 1.0.0-rc.12
- [execall](https://npm.io/package/execall.md) ^2.0.0
- [p-queue](https://npm.io/package/p-queue.md) ^6.6.2
- [filesize](https://npm.io/package/filesize.md) ^6.4.0
- [fs-extra](https://npm.io/package/fs-extra.md) ^11.2.0
- [prettier](https://npm.io/package/prettier.md) ^2.8.8
- [dumper.js](https://npm.io/package/dumper.js.md) ^1.3.1
- [file-type](https://npm.io/package/file-type.md) ^16.5.4
- [json-diff](https://npm.io/package/json-diff.md) ^1.0.6
- [valid-url](https://npm.io/package/valid-url.md) ^1.0.9
- [clipboardy](https://npm.io/package/clipboardy.md) ^4.0.0
- [node-fetch](https://npm.io/package/node-fetch.md) ^2.7.0
- [read-chunk](https://npm.io/package/read-chunk.md) ^3.2.0
- [replaceall](https://npm.io/package/replaceall.md) ^0.1.6
- [async-retry](https://npm.io/package/async-retry.md) ^1.3.3
- [better-queue](https://npm.io/package/better-queue.md) ^3.8.12
- [@rematch/core](https://npm.io/package/@rematch/core.md) ^2.2.0
- [cache-manager](https://npm.io/package/cache-manager.md) ^3.6.3
- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.20.13
- [@rematch/immer](https://npm.io/package/@rematch/immer.md) ^2.1.3
- [axios-rate-limit](https://npm.io/package/axios-rate-limit.md) ^1.3.0
- [gatsby-core-utils](https://npm.io/package/gatsby-core-utils.md) ^4.16.0
- [gatsby-plugin-utils](https://npm.io/package/gatsby-plugin-utils.md) ^4.16.0
- [cache-manager-fs-hash](https://npm.io/package/cache-manager-fs-hash.md) ^0.0.9
- [gatsby-source-filesystem](https://npm.io/package/gatsby-source-filesystem.md) ^5.16.0
- [gatsby-plugin-catch-links](https://npm.io/package/gatsby-plugin-catch-links.md) ^5.16.0
- [fast-json-stable-stringify](https://npm.io/package/fast-json-stable-stringify.md) ^2.1.0

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 7.17.0 (latest) — 2026-01-26
- 7.18.0-next.0 (next) — 2025-11-27
- 7.19.0-react19.2 (react19) — 2025-11-26
- 7.11.1-canary-less-lmdb.0 (less-lmdb) — 2024-12-20
- 7.13.0-alpha-alt-image-cdn.44 (alt-image-cdn) — 2023-11-03
- 6.25.5 (latest-v4) — 2023-05-25
- 7.9.0-image-cdn-configurable.4 (image-cdn-configurable) — 2023-04-11
- 7.9.0-stateful-wp.2 (stateful-wp) — 2023-04-07
- 7.8.0-alpha-wp-inconsistent-schema.29 (wp-inconsistent-schema) — 2023-03-16
- 6.25.3-alpha-wp-preview-errors.13 (wp-preview-errors) — 2023-01-18
- 7.3.0-alpha-wpgql-thirteen.26 (wpgql-thirteen) — 2022-12-07
- 5.15.0 (latest-v3) — 2022-12-07
- 7.3.0-alpha-wpgql-13.36 (wpgql-13) — 2022-12-01
- 7.0.0-alpha-drupal-proxyurl.14 (drupal-proxyurl) — 2022-11-22
- 7.2.0-alpha-wordpress-exclude-fields-on-media-item.14 (wordpress-exclude-fields-on-media-item) — 2022-11-18
- … 918 more at https://npm.io/package/gatsby-source-wordpress/versions

## README

<div align="center" style="margin-bottom: 20px;">
<img src="https://github.com/gatsbyjs/gatsby/raw/master/packages/gatsby-source-wordpress/docs/assets/gatsby-wapuus.png" alt="Wapuu hugging a ball with the Gatsby logo on it" />
</div>

<p align="center">
  <a href="https://github.com/gatsbyjs/gatsby/blob/master/LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="Gatsby and gatsby-source-wordpress are released under the MIT license." />
  </a>
  <a href="https://www.npmjs.com/package/gatsby-source-wordpress">
    <img src="https://img.shields.io/npm/v/gatsby-source-wordpress.svg" alt="Current npm package version." />
  </a>
  <a href="https://npmcharts.com/compare/gatsby-source-wordpress?minimal=true">
    <img src="https://img.shields.io/npm/dm/gatsby-source-wordpress.svg" alt="Downloads per month on npm." />
  </a>
  <a href="https://npmcharts.com/compare/gatsby-source-wordpress?minimal=true">
    <img src="https://img.shields.io/npm/dt/gatsby-source-wordpress.svg" alt="Total downloads on npm." />
  </a>
  <a href="https://gatsbyjs.com/contributing/how-to-contribute/">
    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome!" />
  </a>
</p>

# gatsby-source-wordpress

Source data from WordPress in a scalable and efficient way with WPGraphQL 🚀

This plugin works by merging the [WPGraphQL schema & data](https://docs.wpgraphql.com/guides/about-wpgraphql/) with the [Gatsby schema & Node model](https://www.gatsbyjs.com/docs/node-model/) which allows us to efficiently cache WP data in Gatsby. What this means is that incremental builds, fast builds, and CMS Previews work beautifully! 💅

## Docs 📖

- 👩‍🎤 [Why use this plugin?](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/why-use-this-plugin.md)
- 🏃‍ [Installation & Getting started](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/getting-started.md)
- 🏫 [Tutorials](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/tutorials/index.md)
- 🐾 [Features](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/features/index.md)
- 🔌 [Plugin options](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/plugin-options.md)
- ⛵️ [Migrating from other WP source plugins](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/migrating-from-other-wp-source-plugins.md)
- 🏠 [Hosting WordPress](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/hosting.md)
- 👟 [Themes, Starters, and Examples](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/themes-starters-examples.md)
- 🏅 [Usage with popular WPGraphQL extensions](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/usage-with-popular-wp-graphql-extensions.md)
- 🛠 [Debugging and troubleshooting](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/debugging-and-troubleshooting.md)
- 🏞 [Community and Support](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/community-and-support.md)
- 🌻 [Contributing](https://github.com/gatsbyjs/gatsby/blob/master/packages/gatsby-source-wordpress/docs/contributing.md)
- 🧓 [v3 Documentation](https://github.com/gatsbyjs/gatsby/blob/1da331a5352e3f7cb18f69050b7199481d85fbcb/packages/gatsby-source-wordpress/README.md)

## Relevant Links 🔗

- [WPGatsby](https://github.com/gatsbyjs/wp-gatsby)
- [WPGraphQL](https://github.com/wp-graphql/wp-graphql)
- [Gatsby](https://www.gatsbyjs.com/)
- [WordPress](https://wordpress.com/)

---
_Source: https://npm.io/package/gatsby-source-wordpress · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
