Skip to content

Conversation

@andrealungh1
Copy link

Description

Clarifies the SameSite cookie attribute documentation by replacing incorrect cross-origin terminology with cross-site and by making the description of SameSite=Lax more precise.

Motivation

The SameSite attribute is defined in terms of site (scheme + eTLD+1), not origin. Using cross-origin terminology can mislead readers and make it harder to understand real browser behavior.

Additionally, while the existing description of SameSite=Lax was technically correct, it was imprecise. This update clarifies when cookies are included or omitted by explicitly distinguishing top-level navigations from subresource requests and safe HTTP methods from state-changing ones.

Additional details

Related issues and pull requests

Fixes #42945

@andrealungh1 andrealungh1 requested a review from a team as a code owner January 28, 2026 12:54
@andrealungh1 andrealungh1 requested review from hamishwillee and removed request for a team January 28, 2026 12:54
@github-actions github-actions bot added Content:Security Security docs size/xs [PR only] 0-5 LoC changed labels Jan 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:Security Security docs size/xs [PR only] 0-5 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

SameSite docs use cross-origin terminology and are imprecise about Lax behavior

1 participant