releases.shpreview

\`unsafeMetadata\` deprecated in \`user.update()\`

@clerk/clerk-js@6.16.1

1 enhancementThis release1 enhancementImprovements to existing featuresAI-tallied from the release notes

Patch Changes

  • Migrate the build pipeline to tsdown and TypeScript 6.0. This is an internal tooling change with no intended changes to the public API or runtime behavior. (#8177) by @dstaley

  • Deprecate passing unsafeMetadata to user.update(). (#8587) by @brunol95

    Use user.updateMetadata() when you want to partially update unsafe metadata with deep-merge semantics:

    await user.updateMetadata({
      unsafeMetadata: { onboardingComplete: true },
    });

    user.update({ unsafeMetadata }) continues to work for now and preserves its existing full-replacement behavior:

    await user.update({
      unsafeMetadata: { theme: 'dark' },
    });

    New code should prefer user.updateMetadata({ unsafeMetadata }) for metadata-only updates.

  • Updated dependencies [f046c49, b5fa9f6, 3d5b2fe]:

    • @clerk/shared@4.17.1

Fetched June 11, 2026