Gatsby Cloud Docs

Troubleshooting

Troubleshoot errors with Gatsby Preview

Table of Contents

Troubleshooting

If you encounter an issue with your Gatsby Preview instance not updating, check the Preview Logs for errors. In this section, we’ll document common issues you might encounter, along with solutions and workarounds.

General Build Errors

If you are getting general build errors, this can often mean that your environment variables aren’t set correctly. If you run into a build error, go to the Settings tab for your site and ensure the environment variables are correct and match you gatsby-config.js file.

Build Error: Bitmap

Problem: Gatsby Preview will log an error saying TypeError: Cannot read property ‘bitmap’ of undefined.

Solution: Select Restart on the site Overview page

image of preview log from Bitmap error

image of site overview page with restart button highlighted