Skip to content

docs: clarify instance-local revalidation behavior in multi-instance …#92403

Open
Akash504-ai wants to merge 1 commit intovercel:canaryfrom
Akash504-ai:docs/revalidation-instance-warning
Open

docs: clarify instance-local revalidation behavior in multi-instance …#92403
Akash504-ai wants to merge 1 commit intovercel:canaryfrom
Akash504-ai:docs/revalidation-instance-warning

Conversation

@Akash504-ai
Copy link
Copy Markdown

What?

Adds a clear warning in the "Multi-Instance Considerations" section to highlight that revalidation is instance-local by default in multi-instance or serverless environments.

Why?

While the behavior is already explained later in the section, it is not immediately obvious to most users—especially those deploying on serverless platforms like Vercel.

This can lead to confusion, as developers may assume that revalidateTag() or revalidatePath() invalidates cache globally across all instances, when in reality it only affects the instance handling the request.

How?

  • Added a short ⚠️ Important note at the beginning of the section
  • Did not modify existing content or behavior explanations
  • Improves visibility of a critical limitation without changing meaning

Fixes #92402

@nextjs-bot nextjs-bot added the Documentation Related to Next.js' official documentation. label Apr 6, 2026
@nextjs-bot
Copy link
Copy Markdown
Collaborator

Allow CI Workflow Run

  • approve CI run for commit: 65ea87e

Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Related to Next.js' official documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Revalidation behavior is instance-local by default, not clearly highlighted for multi-instance/serverless environments

2 participants