{"record":{"id":"8e0a55d547a3e015","repo":"gatsbyjs/gatsby","slug":"could-not-process-image-path","errorCode":null,"errorMessage":"Could not process image ${path}","messagePattern":"Could not process image (.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby-plugin-image/src/node-apis/watcher.ts","lineNumber":38,"sourceCode":"  pathPrefix: string\n  createNodeId: ParentSpanPluginArgs[\"createNodeId\"]\n  createNode: Actions[\"createNode\"]\n  cache: GatsbyCache\n  reporter: Reporter\n}): void {\n  // We use a shared watcher, but only create it if needed\n  if (!watcher) {\n    watcher = chokidar.watch(fullPath)\n    watcher.on(`change`, async (path: string): Promise<void> => {\n      reporter.verbose(`Image changed: ${path}`)\n      const node = await createImageNode({\n        fullPath: path,\n        createNodeId,\n        createNode,\n        reporter,\n      })\n      if (!node) {\n        reporter.warn(`Could not process image ${path}`)\n        return\n      }\n      await updateImages({ node, cache, pathPrefix, reporter })\n    })\n  } else {\n    // If we already have a watcher, just add this image to it\n    watcher.add(fullPath)\n  }\n}\n/**\n * Update any static image instances that use a source image\n */\nasync function updateImages({\n  cache,\n  node,\n  pathPrefix,\n  reporter,\n}: {","sourceCodeStart":20,"sourceCodeEnd":56,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby-plugin-image/src/node-apis/watcher.ts#L20-L56","documentation":"Runtime guard in gatsby-plugin-image's chokidar watcher: a file change event fired, but createImageNode returned falsy for the changed path (e.g. the file could not be read or was an unsupported type), so the changed image is not rebuilt and a warning names the path.","triggerScenarios":"Thrown at packages/gatsby-plugin-image/src/node-apis/watcher.ts:38 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify the changed file is a readable, supported image","Re-save the file to retrigger the watcher"],"exampleFix":null,"handlingStrategy":"validation","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-14T05:17:10.506Z"}