Clerk logo

Clerk Docs

Ctrl + K
Go to

Cookieless Development mode

Communicating with the Frontend API without third-party cookies for developments instances

By default, development instances communicate with Clerk's Frontend API using third-party cookies.

Cookieless Development is a new, experimental mode of operation for development instances, in which communication with the Clerk Frontend API is done via URL decoration instead.

This mode only applies to development instances. Production instances remain unaffected and continue communicating with Frontend API using first-party, HttpOnly cookies.

Cookieless Development mode is an experimental feature for now so there might be some rough edges. Let us know if you encounter any issues or have questions, via Support.

Migrating to Cookieless Development

To opt-in to Cookieless Development mode, perform the following steps:

  1. In Dashboard, navigate to your development instance's Settings > Experimental page and toggle on Enable Cookieless development mode.
  2. Upgrade @clerk/clerk-react to v5.4.5 or later. If your are importing @clerk/clerk-js to your project, use v4.18.0 or later.

Clerk Hosted Pages and redirects

In Cookieless development navigating from your application to your Clerk Hosted Pages must be done using the Clerk redirection helpers and React Control Components as shown in the following table:

Destination pageReact componentHelper
Sign-up<RedirectToSignUp />Clerk.redirectToSignUp()
<RedirectToSignIn />Clerk.redirectToSignIn()
User profile<RedirectToUserProfile />Clerk.redirectToUserProfile()
Create organization <RedirectToCreateOrganization /><Clerk.redirectToCreateOrganization()
Organization profile<RedirectToOrganizationProfile />Clerk.redirectToOrganizationProfile()

For custom HTML anchors use the Clerk.redirectWithAuth helper:

Was this helpful?

Clerk © 2022