Disabling Gatsby Telemetry

Hero image for Disabling Gatsby Telemetry. Image by Chris Liverani.
Hero image for 'Disabling Gatsby Telemetry.' Image by Chris Liverani.

If you have set up a fresh Gatsby build recently, you may have noticed that Gatsby now boldly announces that they are collecting anonymous analytics from you. It should not come as a surprise that they feel the need to do this: the more they are able to understand how Gatsby is used (and how it fails), the better as a product it will become.

It is also important to note that the analytics collected relate very specifically to you, the developer, and the environments that you choose to run Gatsby on (although that would also potentially include wherever you choose to run your CI pipeline or deploy). As far as I have been able to ascertain there is no suggestion that they are either now or intending to tracking your users.

Screenshot from Gatsby explaining that it now collects anonymous usage analytics.

It's also fair to say that they aren't going about this in a duplicitous fashion: if you miss the massive notice in your terminal, perhaps you might want to make an appointment with your optometrist.

Nevertheless, the fact that it is enabled (optin) by default is a concern for some, and privacy is an increasingly important thing to keep personal control over. You may also be working under an NDA or other contract that specifically prohibits this type of data sharing (as I often am).

Fortunately, Gatsby also makes it very clear how you can opt out. Either in your terminal, run:

gatsby telemetry --disable

Or open up your .env config and drop this flag in there:

GATSBY_TELEMETRY_DISABLED = 1

Do bear in mind that whichever option you choose, if you are set on stopping Gatsby from collecting data from you, then you will need to repeat the above on any other machines you might also be running your build from.

Personally, I've opted for the environment variable: it is simple and easy to maintain across different environments: quite literally set and forget it.


Categories:

  1. Development
  2. Front‑End Development
  3. Gatsby
  4. Guides
  5. Node.js