Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub


Gatsby plugin to use cookie banner generated with cookiehub.

This plugin works in an easy way together with a plugin to add google analytics GDPR compliant: gatsby-plugin-google-analytics-gdpr

Setup Cookiehub

Setup Cookiehub v2

Setup Cookiehub v1

CookieHub v1 which is being phased out. Version 1 is currently sunsetting and will be shut down in May 2021 (EOL plan).

  • Create CookieHub account.
  • Add widget.
  • Configure widget at least with appropriate categories in the category tab.


npm install --save gatsby-plugin-cookiehub-banner

How to use

// In your gatsby-config.js
module.exports = {
  plugins: [
        resolve: `gatsby-plugin-cookiehub-banner`,
        options: {
            // The ID is part of the CookieHub URL: https://cookiehub.net/cc/YOUR_COOKIEHUB_ID.js
            cookieHubId: "YOUR_COOKIEHUB_BANNER_ID",
            // Optional parameter (default false) - Use new v2 API.
            cookieHubV2Api: false
            // Categories configured with CookieHub
            categories: [
                categoryName: 'analytics', // Unique id of the category which is set by Cookiehub.
                cookieName: 'gatsby-plugin-google-analytics-gdpr_cookies-enabled' // Your custom cookie name
                categoryName: 'marketing',
                cookieName: 'marketing-enabled'

How it works

The plugin embeds the script generated by CookieHub to show the cookie banner. On CookieHub initialization and on user input the plugin sets one cookie per category. Depending on the user input the value should be true or false. You can configure your categories in the gatsby-config.js with the according cookie names.

Cookie Handling Example: If you want to integrate Google Analytics, you can start tracking as soon as the analytics cookie is set to true and disable tracking if the user withdraws the choice.

There is a GDPR plugin to use Google Analytics in an easy way with this plugin: gatsby-plugin-google-analytics-gdpr. Install and configure the gatsby-plugin-google-analytics-gdpr plugin and set the analytics category cookie name to gatsby-plugin-google-analytics-gdpr_cookies-enabled.



The ID is part of the CookieHub URL: https://cookiehub.net/cc/YOUR_COOKIEHUB_ID.js

  • CookieHub v1: Your cookiehub widget ID. You can find the widget ID in the CookieHub tab “Your script” of the appropriate widget.
  • CookieHub v2: Your cookiehub domain code. You can find the code in the overview tab of your configured domain.


Optional parameter (default false). If true the plugin uses the new Cookiehub API v2.


Define your categories configured with CookieHub. A category consists of categoryName and cookieName.


Unique id of the category which you can set in CookieHub categories.


Define a custom cookie name. If none cookieName is given, the plugin will generate one.

© 2023 Gatsby, Inc.