Add decorateUrl to navigate callbacks for Safari ITP support

[nikosdouvlis]

Summary

Updates all custom flow documentation to include the new decorateUrl function in navigate callbacks, enabling Safari ITP cookie refresh support.

• Updated 25 documentation files with the decorateUrl pattern
• Covers all authentication custom flows (current and legacy)
• Includes Expo partial files

Why

Safari's Intelligent Tracking Prevention (ITP) limits cookies set via API responses from CNAME-cloaked subdomains to 7 days. This causes unexpected session expiration for Safari users who don't visit frequently. The decorateUrl function wraps destination URLs and may return an absolute URL when cookie refresh is needed.

The Pattern

All navigate callbacks now use:

navigate: async ({ session, decorateUrl }) => {
  const url = decorateUrl('/')
  if (url.startsWith('http')) {
    window.location.href = url
  } else {
    router.push(url)
  }
}

Related

• JavaScript SDK PR: feat(clerk-js,ui,shared): Add Safari ITP decorateUrl workaround to setActive javascript#7623
• Docs PR for setActive reference: docs: Add Safari ITP documentation for setActive() decorateUrl #3013

Test plan

• Verify code examples render correctly in preview
• Confirm patterns match the reference in PR docs: Add Safari ITP documentation for setActive() decorateUrl #3013

🤖 Generated with Claude Code

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
clerk-docs	Ready	Preview	Feb 10, 2026 3:48pm

[alexisintech]

does this only apply to navigate() for setActive(), or does it apply to the navigate() callback for finalize() as well? (checkout.finalize({ navigate }))

[alexisintech]

thanks nikos 😸💖