docs: note PPR default in cacheComponents reference#92378
Merged
aurorascharff merged 5 commits intocanaryfrom Apr 8, 2026
Merged
docs: note PPR default in cacheComponents reference#92378aurorascharff merged 5 commits intocanaryfrom
aurorascharff merged 5 commits intocanaryfrom
Conversation
nextjs-bot
added
created-by: Next.js DevEx team
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a “Good to know” callout to the cacheComponents API reference to clarify that enabling cacheComponents: true implies Partial Prerendering (PPR) behavior (including ◐ (Partial Prerender) build output) and to point readers to relevant rendering and migration docs.
Changes:
- Add a callout explaining PPR is the default behavior when
cacheComponentsis enabled. - Clarify that legacy experimental PPR config/route segment config is superseded and link to rendering + upgrade guidance.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
docs/01-app/03-api-reference/05-config/01-next-config-js/cacheComponents.mdx
Outdated
Show resolved
Hide resolved
Add a Good to know callout before Navigation with Activity: cacheComponents enables PPR, replaces legacy experimental flags, and explains Partial Prerender in build output with links to Caching and the v16 upgrade guide. Made-with: Cursor
Match Good to know colon style with the Activity callout and split the PPR note into short blockquote paragraphs for readability. Made-with: Cursor
aurorascharff
force-pushed
the
docs/cache-components-ppr-callout
branch
from
61db703 to
fea99a7
Compare
icyJoseph
reviewed
Apr 7, 2026
docs/01-app/03-api-reference/05-config/01-next-config-js/cacheComponents.mdx
Outdated
Show resolved
Hide resolved
…Components.mdx Co-authored-by: Joseph <joseph.chamochumbi@vercel.com>
aurorascharff
commented
Apr 8, 2026
docs/01-app/03-api-reference/05-config/01-next-config-js/cacheComponents.mdx
Outdated
Show resolved
Hide resolved
aurorascharff
commented
Apr 8, 2026
docs/01-app/03-api-reference/05-config/01-next-config-js/cacheComponents.mdx
Outdated
Show resolved
Hide resolved
icyJoseph
approved these changes
Apr 8, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What?
Add a Good to know callout on the
cacheComponentsAPI reference, placed after the Usage list and before Navigation with Activity.Why?
Developers enabling
cacheComponents: truemay see routes built as partial prerenders (◐ (Partial Prerender)) without ever turning on a separate PPR flag. The Caching getting-started guide already explains PPR as the default with Cache Components; this surfaces the same idea on the config page people often open first, and points to migration context for Next.js 15 experimental PPR.How?
Single callout: PPR is used with the flag, legacy
experimental.ppr/experimental_pprare superseded,◐innext buildis expected, with links to How rendering works and Partial Prerendering (PPR) in the Version 16 upgrade guide.PR checklist (Improving Documentation)
pnpm prettier-fixlocally if CI flags anything.Made with Cursor