Clerk Changelog

You can now enable PKCE (Proof Key for Code Exchange) when configuring custom OIDC providers and custom social connections. This enhancement provides better security for applications that cannot securely store client secrets.

What is PKCE?

PKCE is a security extension to the OAuth 2.0 Authorization Code flow. It was originally designed for public clients like mobile and native applications, but is now recommended for all OAuth 2.0 clients as a best practice.

Instead of relying on a static client secret, PKCE creates a cryptographically random secret for each authorization request. This means even if an authorization code is intercepted, it cannot be exchanged for tokens without the original secret.

When to use PKCE

Enable PKCE for:

• Native and mobile apps - These applications cannot securely store client secrets since their code can be reverse-engineered
• Single-page applications (SPAs) - Modern best practice recommends PKCE for browser-based apps
• Any public client - Applications where the source code is accessible to end users

How to enable

To enable PKCE for your custom OAuth provider:

1. Navigate to SSO connections⁠ in your Clerk Dashboard
2. Select your custom OIDC provider or custom social connection
3. Enable the Use PKCE toggle in the Connection tab
4. Save your changes

Once enabled, Clerk will automatically use the Authorization Code with PKCE flow for authentication with that provider.

What’s New

Billing API Redesign

• Introduces a new /billing path to replace the legacy /commerce endpoints for all billing-related functionality.
• Billing amounts are now represented using structured Fee objects instead of top-level fields.
• More details: Guide to Upgrading Your API Version⁠

Overview of Breaking Changes

More details can be found in the upgrade guide linked above.

Hovering or selecting the positive segment will now show you only the active users or organizations for that period as well.

By further combining the New, Retained, and Reactivated filters with the positive or negative segments, you can isolate growth or churn trends and see exactly who is using - or not using - your application.

Head to the Overview page⁠ of your production instance to begin exploring your user base's activity.

The command menu is now live in the Clerk Dashboard. Navigate anywhere with just a few keystrokes, whether you're jumping between workspaces, searching our docs, or finding a specific setting you've never configured before.

Contextual and AI-powered

As your dashboard grows with more workspaces, applications, and settings, finding what you need shouldn't get harder. The command menu unifies your entire dashboard: workspaces, applications, instances, documentation, and settings pages, all in one place.

Know the name of the workspace you want to jump to? Search for it. Don't remember how to use one of our hooks? Search our docs and jump in.

When you don't know the exact name or where something lives, AI steps in. The command menu understands what you're looking for, even when you describe it in plain language.

Don't know where SMS MFA settings live? Type "enable SMS MFA" and it takes you there. Need to change your domain but can't remember if there's even a domains page? Just describe what you need, and the command menu finds it.

It uses your dashboard context to understand what you're trying to do and takes you there.

Get started

Open the command menu with ⌘+K (Mac) or Ctrl+K (Windows/Linux) inside any application in the Clerk Dashboard⁠.

Previously, all free trials required a payment method upfront. Now there's a simple toggle in your billing settings that lets you decide what works best for your business.

Remove Friction, Keep Control

By disabling the payment method requirement, this lets users begin their trial instantly, skipping payment details.

When enabled, you keep the previous behavior where payment methods are required upfront — useful for preventing trial abuse and ensuring smooth transitions to paid subscriptions.

Easy Configuration

Head to your billing settings⁠ in the Clerk Dashboard to find the new toggle.

Get Started

• Configure free trials in the Clerk Dashboard⁠
• Check out the free trials documentation

We're excited to announce that the Clerk Dashboard now includes comprehensive organization growth tracking. Just as you've been able to monitor user growth with detailed retention and churn metrics, you can now access the same level of insight for your organizations.

Organization Growth Chart

The new organization growth chart provides detailed breakdowns of your organization activity over time, tracking new, reactivated, retained, and churned organizations across each period

Flexible Filtering

Organization growth data includes flexible time-based filtering options. You can analyze your data across different time periods to see daily active organizations, weekly active organizations, or monthly active organizations based on which interval you select. Customize date ranges to gain deeper insights into your organization adoption patterns and behavior over time.

Organization Cohort Table

Below the growth chart, you'll find a detailed organization cohort table that provides a granular look at individual organizations, their status, member counts, and creation dates. You can click directly on any segment of the chart above to filter the cohort table and view the specific organizations that make up that data point, making it easy to identify trends and investigate specific cohorts in detail.

This update brings parity between user and organization analytics, giving you a complete picture of growth across your application. Stay tuned for more planned improvements to organization insights!