Skip to content
Projects
Groups
Snippets
Help
Loading...
Sign in
Toggle navigation
N
next.js
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Alex
next.js
Commits
7edc9548
Unverified
Commit
7edc9548
authored
Aug 11, 2026
by
David Alexandru Ilie
Committed by
GitHub
Aug 11, 2026
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Clarify Instant validation opt-outs
parent
7cb68c12
Hide whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
19 additions
and
8 deletions
+19
-8
instant-guidance-data.ts
...s/dev-overlay/components/instant/instant-guidance-data.ts
+3
-3
errors.test.ts
...xt/src/next-devtools/dev-overlay/container/errors.test.ts
+15
-4
instant-messages.ts
packages/next/src/shared/lib/instant-messages.ts
+1
-1
No files found.
packages/next/src/next-devtools/dev-overlay/components/instant/instant-guidance-data.ts
View file @
7edc9548
...
...
@@ -218,12 +218,12 @@ const unrenderedSegmentCards: FixCard[] = [
},
{
id
:
'skip-validation-on-the-segment'
,
title
:
'Skip
validation on the segment
'
,
title
:
'Skip
only this validation
'
,
group
:
'ignore'
,
link
:
'https://nextjs.org/docs/messages/instant-unrendered-segment#skip-validation-on-the-segment'
,
snippets
:
[
{
text
:
'// page.tsx or layout.tsx'
},
{
text
:
''
},
{
text
:
'//
Server
page.tsx or layout.tsx'
},
{
text
:
'
// Prerendering still runs
'
},
{
text
:
'export const instant = false'
,
highlight
:
true
},
],
copyable
:
true
,
...
...
packages/next/src/next-devtools/dev-overlay/container/errors.test.ts
View file @
7edc9548
...
...
@@ -423,9 +423,20 @@ describe('card sets for all error families', () => {
})
it
(
'unrendered-segment'
,
()
=>
{
expect
(
getCards
(
'unrendered-segment'
,
'runtime'
).
map
((
card
)
=>
card
.
id
)
).
toEqual
([
'render-the-dropped-segment'
,
'skip-validation-on-the-segment'
])
const
cards
=
getCards
(
'unrendered-segment'
,
'runtime'
)
expect
(
cards
.
map
((
card
)
=>
card
.
id
)).
toEqual
([
'render-the-dropped-segment'
,
'skip-validation-on-the-segment'
,
])
expect
(
cards
[
1
]).
toMatchObject
({
title
:
'Skip only this validation'
,
snippets
:
[
{
text
:
'// Server page.tsx or layout.tsx'
},
{
text
:
'// Prerendering still runs'
},
{
text
:
'export const instant = false'
,
highlight
:
true
},
],
})
})
it
(
'link-prefetch-partial'
,
()
=>
{
...
...
@@ -517,7 +528,7 @@ describe('getUnrenderedSegmentErrorDetails', () => {
`\n\n
${
label
}
:\n
${
files
.
map
((
p
)
=>
`
${
p
}
`
).
join
(
'
\
n'
)}
`
+
`\n\nWays to fix this:`
+
`\n - [render] Render the dropped segment`
+
`\n - [ignore] Set \`export const instant = false\`
on the dropped segment to skip validation
`
+
`\n - [ignore] Set \`export const instant = false\`
in the dropped segment's Server Component to skip only this validation (prerendering still runs)
`
+
`\n\nLearn more: https://nextjs.org/docs/messages/instant-unrendered-segment`
}
return
new
Error
(
message
)
...
...
packages/next/src/shared/lib/instant-messages.ts
View file @
7edc9548
...
...
@@ -11,7 +11,7 @@ export function createUnrenderedSegmentError(
`\n\n
${
label
}
:\n
${
missingFiles
.
map
((
p
)
=>
`
${
p
}
`
).
join
(
'
\
n'
)}
`
+
`\n\nWays to fix this:`
+
`\n - [render] Render the dropped segment`
+
`\n - [ignore] Set \`export const instant = false\`
to opt the dropped segment out of instant-navigation validation
`
+
`\n - [ignore] Set \`export const instant = false\`
in the dropped segment's Server Component to skip only this validation (prerendering still runs)
`
+
`\n\nLearn more: https://nextjs.org/docs/messages/instant-unrendered-segment`
}
return
new
Error
(
message
)
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment