{"record":{"id":"f3d6ad45a647559c","repo":"gatsbyjs/gatsby","slug":"gatsby-adapter-netlify-excludedatastorefromengin","errorCode":null,"errorMessage":"[gatsby-adapter-netlify] excludeDatastoreFromEngineFunction is set to true but no DEPLOY_URL is set. Disabling excludeDatastoreFromEngineFunction.","messagePattern":"\\[gatsby-adapter-netlify\\] excludeDatastoreFromEngineFunction is set to true but no DEPLOY_URL is set\\. Disabling excludeDatastoreFromEngineFunction\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby-adapter-netlify/src/index.ts","lineNumber":154,"sourceCode":"      if (\n        typeof excludeDatastoreFromEngineFunction === `undefined` &&\n        typeof process.env.GATSBY_EXCLUDE_DATASTORE_FROM_BUNDLE !== `undefined`\n      ) {\n        excludeDatastoreFromEngineFunction =\n          process.env.GATSBY_EXCLUDE_DATASTORE_FROM_BUNDLE === `true` ||\n          process.env.GATSBY_EXCLUDE_DATASTORE_FROM_BUNDLE === `1`\n      }\n\n      if (typeof excludeDatastoreFromEngineFunction === `undefined`) {\n        excludeDatastoreFromEngineFunction = false\n      }\n\n      const deployURL = process.env.NETLIFY_LOCAL\n        ? `http://localhost:8888`\n        : process.env.DEPLOY_URL\n\n      if (excludeDatastoreFromEngineFunction && !deployURL) {\n        reporter.warn(\n          `[gatsby-adapter-netlify] excludeDatastoreFromEngineFunction is set to true but no DEPLOY_URL is set. Disabling excludeDatastoreFromEngineFunction.`\n        )\n        excludeDatastoreFromEngineFunction = false\n      }\n\n      return {\n        excludeDatastoreFromEngineFunction,\n        deployURL,\n        supports: {\n          pathPrefix: true,\n          trailingSlash: [`always`, `never`, `ignore`],\n        },\n        pluginsToDisable: [\n          `gatsby-plugin-netlify-cache`,\n          `gatsby-plugin-netlify`,\n        ],\n        imageCDNUrlGeneratorModulePath: useNetlifyImageCDN\n          ? require.resolve(`./image-cdn-url-generator`)","sourceCodeStart":136,"sourceCodeEnd":172,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby-adapter-netlify/src/index.ts#L136-L172","documentation":"Degrade-to-safe-default warning in createNetlifyAdapter: excludeDatastoreFromEngineFunction was enabled (via plugin option or GATSBY_EXCLUDE_DATASTORE_FROM_BUNDLE) and the adapter wanted to copy the datastore to Netlify's CDN by fetching the deploy URL, but no DEPLOY_URL/NETLIFY_LOCAL equivalent was present in the environment. Since the datastore can only be excluded when its download URL is known, the adapter logs this notice and silently disables the optimization (falls back to bundling the datastore in the function).","triggerScenarios":"Thrown at packages/gatsby-adapter-netlify/src/index.ts:154 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Ensure the build runs in a real Netlify CI context where DEPLOY_URL (or NETLIFY_LOCAL with the dev server on localhost:8888) is set","Set DEPLOY_URL explicitly to the public URL of the deployment if building outside Netlify","If the optimization is not needed, leave excludeDatastoreFromEngineFunction unset/false so the warning path is never taken"],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"e85d62f1779e353eaac1753211629a26d123e26c","analyzedAt":"2026-08-26T17:50:09.662Z","contentChangedAt":"2026-08-26T17:50:09.662Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}