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.

{
  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.

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.

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!

How to Create Multilingual Pages Using Gatsby, Drupal and GraphQL

Adding the GraphQL Query to Fetch Multi-language Nodes

Creating the Pages

Adding the GraphQL Query to Your Template Page

Wrapping Up

About the author

From Contentful to WordPress: How We Delivered Zero-Downtime Migration for a High-Growth B2B SaaS Company

How We Use AI to Accelerate Web Accessibility Auditing: From Weeks to Minutes

Take your project to the next level!