Publishable and Secret Keys
If your application was created after January 18, 2023, you're already using Publishable and Secret Keys.
In early Clerk SDKs, developers were required to configure three keys:
- Frontend API URL
- API key
- JWT key (depending on the SDK version)
New SDKs have replaced these with two keys:
- Publishable key (prefixed with
- Secret key (prefixed with
The name and format of these keys are common among developer tools, and we adopted them to provide a more familiar developer experience.
Although legacy keys will remain operational, we have updated our documentation and code samples to use the new Publishable Key and Secret Key format.
Important: Legacy keys cannot be mixed with the new publishable and secret keys. It is important that you replace all keys at once.
We recommend updating at your earliest convenience.
Last updated on September 29, 2023