Skip to content

Conversation

@nikosdouvlis
Copy link
Member

Adds documentation for the Safari ITP cookie workaround introduced in clerk/javascript#7623

Summary

  • Added decorateUrl parameter to SetActiveParams navigate callback documentation
  • Added "Safari cookie limitations" section to the Clerk class reference explaining:
    • Why Safari's ITP limits cookies to 7 days
    • How to use decorateUrl to enable automatic cookie refresh
    • Code example showing the recommended pattern

The docs will be available at /docs/reference/javascript/clerk#safari-cookie-limitations

@nikosdouvlis nikosdouvlis requested a review from a team as a code owner January 29, 2026 13:37
@vercel
Copy link

vercel bot commented Jan 29, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview Feb 4, 2026 9:09am

Request Review

Add documentation for the Safari cookie limitation workaround:
- Added decorateUrl parameter to SetActiveParams navigate callback
- Added Safari cookie limitations section to Clerk class reference
- Fix Sarah's comments: navigation URLs → destination URLs, em-dash → spaced dash
- Address Bryce's comment: clarify that ITP affects __client cookie specifically,
  not all JS cookies. The limitation is due to CNAME cloaking on clerk. subdomain
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants