{"record":{"id":"7493763e56fb2481","repo":"vercel/next.js","slug":"partialprefetching-requires-cachecomponents-to","errorCode":null,"errorMessage":"`partialPrefetching` requires `cacheComponents` to be enabled. Please update your ${configFileName} accordingly.","messagePattern":"`partialPrefetching` requires `cacheComponents` to be enabled\\. Please update your (.+?) accordingly\\.","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/next/src/server/config.ts","lineNumber":569,"sourceCode":"    if (\n      result.experimental.turbopackRustReactCompiler &&\n      !result.reactCompiler\n    ) {\n      throw new Error(\n        `\\`experimental.turbopackRustReactCompiler\\` requires \\`reactCompiler\\` to be enabled. ` +\n          `Please add \\`reactCompiler: true\\` in ${configFileName}.`\n      )\n    }\n  }\n\n  if (result.experimental.cachedNavigations && !result.cacheComponents) {\n    throw new Error(\n      `\\`experimental.cachedNavigations\\` requires \\`cacheComponents\\` to be enabled. Please update your ${configFileName} accordingly.`\n    )\n  }\n\n  if (result.partialPrefetching && !result.cacheComponents) {\n    throw new Error(\n      `\\`partialPrefetching\\` requires \\`cacheComponents\\` to be enabled. Please update your ${configFileName} accordingly.`\n    )\n  }\n\n  if (result.experimental.ppr) {\n    throw new HardDeprecatedConfigError(\n      `\\`experimental.ppr\\` has been merged into \\`cacheComponents\\`. The Partial Prerendering feature is still available, but is now enabled via \\`cacheComponents\\`. Please update your ${configFileName} accordingly.`\n    )\n  }\n\n  if (result.output === 'export') {\n    if (result.i18n) {\n      throw new Error(\n        'Specified \"i18n\" cannot be used with \"output: export\". See more info here: https://nextjs.org/docs/messages/export-no-i18n'\n      )\n    }\n\n    if (!hasNextSupport) {","sourceCodeStart":551,"sourceCodeEnd":587,"githubUrl":"https://github.com/vercel/next.js/blob/0ae8c72462952df163f1b1e0726641bc5b40dc93/packages/next/src/server/config.ts#L551-L587","documentation":"`partialPrefetching` controls partial (PPR-style) prefetch behavior that only works when `cacheComponents` is enabled. If partialPrefetching is truthy and cacheComponents is falsy, normalization throws. Checked every phase.","triggerScenarios":"Setting `partialPrefetching: true` at the top level without also enabling `cacheComponents: true`.","commonSituations":"Following an older guide that mentioned partialPrefetching as a standalone toggle. Migrating from experimental.ppr and setting partialPrefetching instead of cacheComponents.","solutions":["Enable cacheComponents: add `cacheComponents: true`","Remove partialPrefetching if cacheComponents is not intended"],"exampleFix":"// before\nmodule.exports = { partialPrefetching: true }\n// after\nmodule.exports = {\n  cacheComponents: true,\n  partialPrefetching: true\n}","handlingStrategy":"validation","validationCode":"if (partialPrefetching && !cacheComponents) {\n  throw new Error('Enable cacheComponents before partialPrefetching')\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Gate partialPrefetching on cacheComponents being on","Keep cacheComponents-dependent flags grouped in config"],"tags":["config","caching","prefetch","cache-components"],"analyzedSha":"0ae8c72462952df163f1b1e0726641bc5b40dc93","analyzedAt":"2026-08-06T19:44:29.143Z","schemaVersion":2},"datasetVersion":"2026-08-07T02:17:10.218Z"}