Gatsby Book Launch

“The missing guide to the modern web” launches on Thursday, Sep 29th: Modular: The Web’s New Architecture

ContactSign Up for Free
Community Plugin
View plugin on GitHub


A plugin to extend Strapi Source plugin.

  • You can have Dynamic Zone usable, not a JSON object ;
  • Images in Dynamic Zone can be used with gatsby-image.

Tested with:

  • "gatsby-source-strapi": "^1.0.1"
  • "strapi": "3.6.8"
  • "gatsby": "^4.4.0"

License Version Gatsby Version Strapi Version gatsby-source-strapi Version React Version


More informations in


npm i gatsby-plugin-strapi-source-extender
yarn install gatsby-plugin-strapi-source-extender


// ./gatsby-config.js
module.exports = {
        resolve: 'gatsby-plugin-strapi-source-extender',
        options: {
        postfix: 'Ext',
        showLog: false,
        strapiTypes: [
            { type: 'StrapiPage', dynamicZones: ['contentSections'] },
            { type: 'StrapiGlobal' },


Property Usage
postfix The postfix of name of the new type, default : Ext. Eg. <StrapiSouceType>Postfix
showLog Display log messages, default : false
strapiTypes All the Strapi types to manage.
strapiTypes.type Name of the Strapi type to manage.
strapiTypes.dynamicZones All the Dynamic Zones (root only) to manage.


GraphQL exemple.

contentSections is a Dynamic zone

For each elements in the Dynamic zone, you must request two properties :

  • __typename to assign a behavior to the component ;
  • order to keep the order of components as they are in Strapi admin.
query DynamicPageQuery($id: String!, $locale: String!) {
    strapiPage: strapiPageExt(id: { eq: $id }) {
      contentSections {
        sectionsHeroImage {

Gatsby exemple.

The Dynamic Zone content with this plugin is not a JSON, it’s an Object, but not an Array. Instead of, you’ll have null components repeated.

Because is an object, you can’t iterate into, so add this :

// sections is an object, our Dynamic zone
// dzSanitized is an Array, our Dynamic zone sorted

const dzSanitized = []

// Remove empty datas
Object.keys(dz).forEach(key => {
  if (dz[key]) {
    Object.keys(dz[key]).forEach(microKey => {
      dz[key][microKey] ? dzSanitized.push(dz[key][microKey]) : ''

// Order array like in Strapi Admin
dzSanitized.sort(function (a, b) {
  return a.order - b.order

Or you can use the helper :

import { StrapiExtenderUtils } from 'gatsby-plugin-strapi-source-extender'
  StrapiExtenderUtils.objectToArray(sections).map((section, i) => {
    return (
        key={`${section.__typename}${(, i)}`}
© 2022 Gatsby, Inc.