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


Gatsby plugin to apply context to every page

Travis npm

This plugin adds context values to every page in your Gatsby project. Use this if you want to add a “global variable” that any page can use in its GraphQL query.


npm install gatsby-plugin-global-context


Add the plugin to gatsby-config.js:

module.exports = {
  plugins: [
      resolve: 'gatsby-plugin-global-context',
      options: {
        context: {
          kittens: true

Now, any page will have access to the values defined in context above. This includes pages in your pages/ folder, and pages created with Gatsby’s createPage().

import React from 'react';
import { graphql } from 'gatsby';

export default () => <h1>Hi, I am a page</h1>;

export const query = graphql`
  query PageQuery($kittens: Boolean!) {
    # ...


The only option is context, which should be an object of context values to add to every page.

Local Development

git clone
cd gatsby-plugin-global-context
npm install
npm test


MIT © Geoff Kimball

© 2022 Gatsby, Inc.