Skip to main content

Clerk Changelog

Filter test users in Overview analytics

Category
Dashboard
Published

Filter out test users from the Clerk Dashboard Overview

The Overview page now includes a Filter test users setting for the Users view. User analytics previously showed combined regular and test user data. Now, when the toggle is enabled, test users are excluded from all Overview charts and metrics.

Test users are defined as having:

  • +clerk_test in the email identifier
  • +15555550100 as the phone

Open the Clerk Dashboard and use the Overview settings menu in the users view to try it.

Contributor
Chase Austin

Share this article

Annual-only plans for Clerk Billing

Category
Billing
Published

Create plans that require an annual subscription

Clerk Billing now has support for annual-only subscriptions. Previously, all plans renewed monthly with an option to subscribe on an annual basis. Now, you can configure plans to support annual-only billing.

To enable support for annual-only plans, visit your applications Updates page to opt-in to annual-only plans.

Important

Opting into annual-only plans will result in the fee property of plans potentially being null. Please ensure any logic your application has that interacts with the fee property is updated to account for null values.

To configure a plan for annual-only billing, enable only the "Annual base fee" option in the plan settings.

Screenshot of the Pricing details section of the plan creation screen, showing the annual base fee toggle in the on position
Contributor
Clerk

Share this article

Preview Custom Session Claims

Category
Dashboard
Published

See a preview of custom session claims before applying

When customizing session tokens, you can now preview the resulting claims before saving your changes.

Select a user to generate claims based on the current template. This lets you verify that custom claims, template expressions, and organization data produce exactly the claims you expect.

Previously, saving a template then inspecting a real session token was required to check the template is correct. Preview lets you ensure expected behavior before impacting real users.

Preview of custom session claims
Contributors
Graham Allan
Nate Watkin

Share this article

Restrict your end users from modifying their email address, phone number, or username after sign up.

You can now prevent end users from adding new or modifying existing email addresses, phone numbers, or usernames after they have signed up through the new Restrict changes toggle in the Clerk Dashboard. Navigate to the User & authentication page to enable.

Clerk Dashboard restrict changes in email address after sign up

Enabling this feature gives you the ability to have maximal control over the exact identifiers your end users can use to sign in to your application. If you'd like to control which identifiers are allowed at sign-up rather than locking them afterwards, see restrictions for allowlists, blocklists, and disposable email blocking.

With this setting enabled, your end users will still be able to view their identifiers in their User Profile, but will not be able to add, remove, or modify the respective identifier. For email addresses, this restriction extends to social connections: End users are prohibited from connecting an OAuth account that would otherwise add a new email address to their account.

Of course, you still have the ability to modify their end users' identifiers at any time on the Users page of the Clerk Dashboard or using our Backend API.

If you would like to have support for restricting end users from changing other attributes than email address, phone number, or username, please reach out to us to share this feedback.

Contributor
Daniel Moerner

Share this article

Include seat limits in your organization billing plans

Starting today, membership limits on organizations can be granted directly by subscribing to a Clerk Billing plan, allowing organizations to purchase a higher membership limit in a self-serve fashion.

This makes it possible to target plans to organizations of specific size. For example, you may let organizations use your most affordable plan for up to ten seats, but require them to upgrade to a more expensive plan to get unlimited seats.

A pricing table for 3 different plans, with different seat limits on each plan

Seat limits are enforced automatically through the integration of Clerk's Billing and B2B Authentication products. When an organization hits its seat limit, Clerk will prevent adding additional members and guide users toward upgrading.

A disabled invitation button with a message indicating the user needs to upgrade their plan.

More seat-based features to come

This release is our first step towards seat-based billing for Clerk Billing. We know that many use cases require organizations to be able to purchase a specific number of seats specified at checkout at a per-seat cost; we hope to have more to say on that functionality in the near future. We're excited to ship this first step into seat-based billing and to expand on it.

How to create a seat-limited plan

  • Navigate to the New Organization plan page in your instance's settings.
  • Toggle on the Seat-based section.
  • If you'd like the plan to convey an unlimited number of seats, leave Unlimited members selected. (You need to have the B2B Authentication add-on to select this option.)
  • If you'd like to set a limit, select Custom limit and enter the limit.
Contributors
Lamone Armstrong
Mary Zhong
Maurício Antunes
Dylan Staley
George Vanjek
Paddy Carver

Share this article

Overview for waitlist mode

Category
Dashboard
Published

The Overview page now has a dedicated waitlist view so it's easier to understand sign-up access and recent waitlist activity.

This new section brings the most relevant waitlist information into one place, so you can understand sign-up access without jumping between pages.

This makes it easier to see how many users are waiting for access, how many have already been invited, and which recent entries may need follow-up.

Features

  • Waitlist counts: Track how many users are on the waitlist, how many have been invited, and how many have been accepted.
  • Recent entries: Review recent waitlist activity directly from the Overview page, including a new infinite scroll table for large waitlists.
  • Faster follow-up: Jump from the overview to the full waitlist view when you need to take action.

Open the Overview page for your production instance in waitlist mode in the Clerk Dashboard to see the new experience.

Contributor
Rafael Camargo

Share this article