releases.shpreview

Clerk.uiVersion exposed; SSO overview condensed

@clerk/shared@4.21.0

2 features5 enhancementsThis release2 featuresNew capabilities5 enhancementsImprovements to existing featuresAI-tallied from the release notes

Minor Changes

  • Expose the loaded @clerk/ui version on the Clerk object via a new uiVersion property. It returns the version of the prebuilt UI bundle once it has loaded (for example Clerk.uiVersion in the browser console), or undefined if the UI has not been loaded yet. @clerk/clerk-js and @clerk/ui are versioned and loaded independently, so uiVersion can differ from Clerk.version. (#8931) by @jacekradko

  • Make OAuthProviderData.docsUrl optional and remove the Enstall OAuth provider docs URL. (#8885) by @SarahSoutoul

Patch Changes

  • Condense the OrganizationProfile Security page SSO overview to a single summary row (one-line description, domains as chips, status badge, actions under the overflow menu) and remove the now-unused ssoSection provider/sign-on URL/issuer/descriptionLine2 localization keys. (#8915) by @iagodahlem

  • Add a generic FLOW_STEP_MOUNTED telemetry event (eventFlowStepMounted) for measuring multi-step flow funnels, and wire it into the self-serve SSO flow (#8951) by @LauraBeatris

  • Add localization support for OAuth access denied errors. (#8786) by @wobsoriano

  • Allow changing enterprise connection provider between self-serve SSO steps (#8881) by @LauraBeatris

  • Improve UserButton and OrganizationSwitcher accessibility. The trigger button now announces itself as a dialog trigger (aria-haspopup="dialog") and the popover uses role="dialog" instead of role="menu". UserButton and OrganizationSwitcher popovers now receive focus when opened, and actions are logically grouped with labelled role="group" elements for screen readers. (#8325) by @alexcarpenter

Fetched June 23, 2026