How to Create Multilingual Pages Using Gatsby, Drupal and GraphQL
Releasing the power of multi-language content in your Drupal-based website can be a game changer in reaching a global audience. But how can you access these language-specific pages with Gatsby and GraphQL? In this blog post, we'll walk you through the steps to seamlessly retrieve multi-language nodes of the type "page" from Drupal. Then, by leveraging the GraphQL module and a few handy code snippets, you'll then be well on your way to delivering a truly multilingual web experience.
To try this code, use the gatsby-source-graphql or the gatsby-source-drupal-graphql plugin.
Adding the GraphQL Query to Fetch Multi-language Nodes
To fetch multi-language nodes of the type "page" from Drupal using Gatsby and the GraphQL module, you need to add to your gatsby-node.js file the following GraphQL query.
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
{
drupal {
pages: nodeQuery(
filter: {
conditions: [
{ operator: EQUAL, field: "status", value: ["1"] }
{ operator: EQUAL, field: "type", value: ["page"] }
]
}
) {
entities {
entityTranslations {
entityId
entityLanguage {
id
}
... on Drupal_Node {
path {
alias
}
}
}
}
}
}
}
As you can see, we are using entityTranslations to extract fields instead of entities directly. This allows us to fetch all translated nodes for that particular node.
Creating the Pages
Once you have the query, you can iterate the result to create your pages by calling a template file.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
const pages = result.data.drupal.pages.entities
pages.forEach((page) => {
page.entityTranslations.forEach((entity) => {
const pathAlias = entity.path.alias.toLowerCase().replace("/homepage", "/")
createPage({
path: pathAlias,
component: path.resolve(`./src/templates/page.js`),
context: {
id: entity.entityId,
language: calculateLanguage(entity.entityLanguage.id),
},
})
})
})
The calculateLanguage function is a helper used to transform language value as a valid Language type.
Adding the GraphQL Query to Your Template Page
Finally, your page template should have a page query like this.
In this GraphQL query, we pass node id and language to the nodeById query to fetch the node in the language we use as a filter.
1
2
3
4
5
6
7
8
9
export const pageQuery = graphql`
query page($id: String!, $language: Drupal_LanguageId!) {
drupal {
page: nodeById(id: $id, language: $language) {
...NodePage
}
}
}
`
We use the custom GraphQL fragment ...NodePage to define the properties/fields we want to query from the content node.
Wrapping Up
You've just unlocked a new language flexibility for your Drupal website powered by Gatsby. By incorporating the provided GraphQL queries and integrating them into your gatsby-node.js and template files, you can effortlessly fetch multi-language pages from Drupal. Language barriers won't prevent your site from captivating audiences worldwide.
Remember to embrace the power of entityTranslations, create your pages dynamically and use the NodePage fragment to customize the properties you want to query. With these tools, you can take your website to new linguistic horizons. So harness the power of multilingualism and let your website shine in every language imaginable!
About the author
The Future of Web Application Development Beyond 2025
By Jorge Valdez, January 7, 2025Web applications have experienced many changes throughout the years, from static websites to AI-driven tools, PWAs, IoT integration, and more. Discover key trends shaping web application development’s future and learn why traditional websites remain relevant in a hybrid digital ecosystem.
Web Applications Types and Examples To Know in 2025
By Jorge Valdez, December 11, 2024In 2025, web apps have various types and examples, but you don’t need to know them all. Our latest article focuses on the most important ones for developers. Learn what really matters in the world of web applications in this article!
Take your project to the next level!
Let us bring innovation and success to your project with the latest technologies.