{"record":{"id":"e99d6be73c32524e","repo":"gatsbyjs/gatsby","slug":"there-was-a-problem-loading-plugin-pluginname","errorCode":null,"errorMessage":"There was a problem loading plugin \"${pluginName}\". Perhaps you need to install its package?\nUse --verbose to see actual error.","messagePattern":"There was a problem loading plugin \"(.+?)\"\\. Perhaps you need to install its package\\?\nUse --verbose to see actual error\\.","errorType":"panic","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby/src/bootstrap/load-plugins/resolve-plugin.ts","lineNumber":91,"sourceCode":"    const packageJSON = JSON.parse(\n      fs.readFileSync(`${resolvedPath}/package.json`, `utf-8`)\n    )\n    warnOnIncompatiblePeerDependency(packageJSON.name, packageJSON)\n\n    return {\n      resolve: resolvedPath,\n      id: createPluginId(packageJSON.name),\n      name: packageJSON.name,\n      version: packageJSON.version,\n    }\n  } catch (err) {\n    if (process.env.gatsby_log_level === `verbose`) {\n      reporter.panicOnBuild(\n        `plugin \"${pluginName} threw the following error:\\n`,\n        err\n      )\n    } else {\n      reporter.panicOnBuild(\n        `There was a problem loading plugin \"${pluginName}\". Perhaps you need to install its package?\\nUse --verbose to see actual error.`\n      )\n    }\n    throw new Error(`unreachable`)\n  }\n}\n","sourceCodeStart":73,"sourceCodeEnd":98,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby/src/bootstrap/load-plugins/resolve-plugin.ts#L73-L98","documentation":"resolvePlugin failed while resolving a plugin's package (require.resolve of package.json, JSON parse, or version parsing). The non-verbose message hides the raw error and suggests the package may not be installed; --verbose reveals the actual cause via panicOnBuild.","triggerScenarios":"Thrown at packages/gatsby/src/bootstrap/load-plugins/resolve-plugin.ts:91 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Install the missing plugin package (npm install)","Run gatsby with --verbose to see the underlying error","Fix typos in the plugin's resolve/name in gatsby-config"],"exampleFix":null,"handlingStrategy":"try-catch","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"}