Skip to content

docs: add deploymentId config and clarify encryption key for self-hosting#89795

Merged
icyJoseph merged 11 commits intocanaryfrom
docs/deployment-id-encryption-key
Feb 12, 2026
Merged

docs: add deploymentId config and clarify encryption key for self-hosting#89795
icyJoseph merged 11 commits intocanaryfrom
docs/deployment-id-encryption-key

Conversation

@icyJoseph
Copy link
Member

@icyJoseph icyJoseph commented Feb 11, 2026

@nextjs-bot nextjs-bot added created-by: Next.js DevEx team PRs by the DX team. Documentation Related to Next.js' official documentation. labels Feb 11, 2026
@icyJoseph icyJoseph requested a review from mischnic February 11, 2026 00:38
@mischnic
Copy link
Member

mischnic commented Feb 11, 2026

we should also add this fact from Tim:

Skew protection is protecting your static .js .css etc. and server actions, not the navigations

@mischnic
Copy link
Member

We should also highlight that because Nextjs itself never reads the ?dpl= query string of incoming, it relies on some proxy in front to handle the routing.

@icyJoseph icyJoseph marked this pull request as ready for review February 11, 2026 11:20
icyJoseph and others added 2 commits February 12, 2026 00:53
Co-authored-by: Allen Zhou <46854522+allenzhou101@users.noreply.github.com>
@icyJoseph icyJoseph merged commit 6627734 into canary Feb 12, 2026
73 checks passed
@icyJoseph icyJoseph deleted the docs/deployment-id-encryption-key branch February 12, 2026 15:33
Comment on lines +219 to +221
- Static assets include a `?dpl=<deploymentId>` query parameter
- Client-side navigation requests include an `x-deployment-id` header
- The server compares the client's deployment ID with its own
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

so this list exists two times now?

once here and then another time (slightly differently) in docs/01-app/03-api-reference/05-config/01-next-config-js/deploymentId.mdx

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I think that's OK, because it is a Guide vs API Reference

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Feb 27, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

created-by: Next.js DevEx team PRs by the DX team. Documentation Related to Next.js' official documentation. locked

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants