How to Retrieve Drupal Nodes in Draft State in Gatsby Development Mode

When working with Gatsby and Drupal, it's essential to ensure that your website's content appears exactly as intended, even when dealing with unpublished draft content. But how can you achieve this without compromising your development process?
In this blog post, we'll unveil a simple yet powerful technique to fetch and display draft nodes using Gatsby seamlessly.
Using NODE_ENV to Filter Nodes
Using this simple code example, you can include nodes on Draft state only in development "gatsby develop".
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
exports.createPages = ({ graphql, actions }) => {
const { createPage } = actions
const status = process.env.NODE_ENV === 'production' ? '["1"]' : '["0", "1"]'
return graphql(`
{
drupal {
articles: nodeQuery(
filter: {
conditions: [
{ operator: IN, field: "status", value: ${status} }
{ operator: EQUAL, field: "type", value: ["article"] }
]
}
sort: [{ field: "created", direction: DESC }]
) {
entities {
entityId
entityLabel
... on Drupal_Node {
status
path {
alias
}
}
}
}
}
}
`).then((result) => {
if (result.errors) {
throw result.errors
}
const { articles } = result.data.drupal
articles.entities.forEach((article) => {
createPage({
path: article.path.alias,
component: path.resolve(`./src/templates/article.js`),
context: {
slug: article.path.alias,
id: article.entityId,
},
})
})
})
}
This code sets a value to the status constant based on the process.env.NODE_ENV value and then uses that value to fetch Published nodes on production and Draft + Published nodes while running in development mode.
Wrapping Up
The objective of fetching only published content on production is to hide those nodes while executing the build process and avoid deploying unpublished content.
Efficiently managing content visibility during the development process is crucial for any Gatsby and Drupal project. Using our code example, you can effortlessly include draft nodes only when running in development mode, ensuring a crystal-clear preview of your unpublished content. With this technique, you'll control what is displayed in production while seamlessly testing and refining your website's user experience. Unlock the power of Gatsby and Drupal while keeping unpublished content under wraps, and propel your development workflow to new heights.

About the author

Why Most Open-Source Projects Fail and How to Improve Your Odds
By Omar Aguirre, February 12, 2026Why so many open source projects fail? Mostly, due to wrong motivations. Discover sustainable approaches to open source development that prevent project abandonment and build long-term success.

Drupal Decoupled Now Supports Drupal 11
By Omar Aguirre, January 26, 2026Drupal Decoupled now supports Drupal 11 with updated modules, streamlined recipes, and a clear path forward for Canvas integration in the near future.
Take your project to the next level!
Let us bring innovation and success to your project with the latest technologies.