From 0de860cf51c3739b27df8aca8f66c0109a29c09b Mon Sep 17 00:00:00 2001
From: Mike Wickett <mikewickett@clerk.dev>
Date: Tue, 28 Jul 2026 13:46:33 -0400
Subject: [PATCH] docs(*): rename "Client Trust" to "Device Trust"

Renames the customer-facing feature name in the SignInFutureResource.status
JSDoc and in the @clerk/upgrade core-3 change guide.

This is a naming change only. Every API value keeps its existing name --
the `needs_client_trust` sign-in status, the `clientTrustState` property,
and the rest are untouched -- so consumers need no code changes.

The patch changeset is required so a release publishes: the clerk-docs
typedoc sync is release-gated, and the generated
clerk-typedoc/shared/sign-in-future-resource/properties.mdx must pick up
the new links before the docs rename can land.

Part of PROT-875.
---
 .changeset/rename-client-trust-to-device-trust.md         | 6 ++++++
 packages/shared/src/types/signInFuture.ts                 | 2 +-
 .../changes/needs-client-trust-sign-in-status-added.md    | 8 ++++----
 3 files changed, 11 insertions(+), 5 deletions(-)
 create mode 100644 .changeset/rename-client-trust-to-device-trust.md

diff --git a/.changeset/rename-client-trust-to-device-trust.md b/.changeset/rename-client-trust-to-device-trust.md
new file mode 100644
index 00000000000..27ec155c7f2
--- /dev/null
+++ b/.changeset/rename-client-trust-to-device-trust.md
@@ -0,0 +1,6 @@
+---
+'@clerk/shared': patch
+'@clerk/upgrade': patch
+---
+
+Rename "Client Trust" to "Device Trust" in documentation strings and links. This is a naming change only — the `needs_client_trust` sign-in status, the `clientTrustState` property, and every other API value keep their existing names, so no integration changes are required.
diff --git a/packages/shared/src/types/signInFuture.ts b/packages/shared/src/types/signInFuture.ts
index d46ce7e0f20..59941ee856a 100644
--- a/packages/shared/src/types/signInFuture.ts
+++ b/packages/shared/src/types/signInFuture.ts
@@ -342,7 +342,7 @@ export interface SignInFutureResource {
    * The current status of the sign-in.
    * <ul>
    * <li>`'complete'` - The sign-in process has been completed successfully.</li>
-   * <li>`'needs_client_trust'` - The user is signing in from a new device and must complete a [second factor verification](!second-factor-verification) to establish [Client Trust](https://clerk.com/docs/guides/secure/client-trust). See the [Client Trust custom flow guide](https://clerk.com/docs/guides/development/custom-flows/authentication/client-trust) for more information.</li>
+   * <li>`'needs_client_trust'` - The user is signing in from a new device and must complete a [second factor verification](!second-factor-verification) to establish [Device Trust](https://clerk.com/docs/guides/secure/device-trust). See the [Device Trust custom flow guide](https://clerk.com/docs/guides/development/custom-flows/authentication/device-trust) for more information.</li>
    * <li>`'needs_identifier'` - The user's identifier (e.g., email address, phone number, username) hasn't been provided.</li>
    * <li>`'needs_first_factor'` - One of the following [first factor verification](!first-factor-verification) strategies is missing: `'email_link'`, `'email_code'`, `passkey`, `password`, `'phone_code'`, `'web3_base_signature'`, `'web3_metamask_signature'`, `'web3_coinbase_wallet_signature'`, `'web3_okx_wallet_signature'`, `'web3_solana_signature'`, [`OAuthStrategy`](https://clerk.com/docs/reference/types/sso#o-auth-strategy), or `'enterprise_sso'`.</li>
    * <li>`'needs_second_factor'` - One of the following [second factor verification](!second-factor-verification) strategies is missing: `'phone_code'`, `'totp'`, `'backup_code'`, `'email_code'`, or `'email_link'`.</li>
diff --git a/packages/upgrade/src/versions/core-3/changes/needs-client-trust-sign-in-status-added.md b/packages/upgrade/src/versions/core-3/changes/needs-client-trust-sign-in-status-added.md
index 605a77c4fba..c5aa2470e08 100644
--- a/packages/upgrade/src/versions/core-3/changes/needs-client-trust-sign-in-status-added.md
+++ b/packages/upgrade/src/versions/core-3/changes/needs-client-trust-sign-in-status-added.md
@@ -1,16 +1,16 @@
 ---
-title: 'Sign-in Client Trust status handling'
+title: 'Sign-in Device Trust status handling'
 category: 'breaking'
 ---
 
 We've added a new Sign-in status of `needs_client_trust` which, given the conditions listed, will need to be handled in your application.
 
-[Clerk Documentation: Client Trust](https://clerk.com/docs/guides/secure/client-trust)
+[Clerk Documentation: Device Trust](https://clerk.com/docs/guides/secure/device-trust)
 
 Prerequisites:
 
-- [Passwords and Client Trust](https://dashboard.clerk.com/~/user-authentication/user-and-authentication?user_auth_tab=password) are enabled.
-- You've opted-in to the Client Trust `needs_client_trust` [Update](https://dashboard.clerk.com/~/updates).
+- [Passwords and Device Trust](https://dashboard.clerk.com/~/user-authentication/user-and-authentication?user_auth_tab=password) are enabled.
+- You've opted-in to the Device Trust `needs_client_trust` [Update](https://dashboard.clerk.com/~/updates).
 - Sign-in with [Email](https://dashboard.clerk.com/~/user-authentication/user-and-authentication) and/or [Phone](https://dashboard.clerk.com/~/user-authentication/user-and-authentication?user_auth_tab=phone) identifiers are enabled.
 - If [Email](https://dashboard.clerk.com/~/user-authentication/user-and-authentication) or [SMS](https://dashboard.clerk.com/~/user-authentication/user-and-authentication?user_auth_tab=phone) sign-in verification aren't enabled.