Update Clerk.session description to not mention active status (#2597)

LauraBeatris · alexisintech · web-flow · commit 0ed854cdc30a · 2025-09-25T18:42:00.000-04:00
Co-authored-by: Alexis Aguilar &lt;98043211+alexisintech@users.noreply.github.com&gt;
diff --git a/docs/_partials/hooks/use-auth.mdx b/docs/_partials/hooks/use-auth.mdx
@@ -1,6 +1,6 @@
 {/* TODO: Keep in sync with /tanstack-react-start/read-session-data and /expo/read-session-user-data */}
 
-The following example uses the [`useAuth()`](/docs/reference/hooks/use-auth) hook to access the current auth state, as well as helper methods to manage the current active session. The following example demonstrates how to use the available properties of the `useAuth()` hook.
+The following example uses the [`useAuth()`](/docs/reference/hooks/use-auth) hook to access the current auth state, as well as helper methods to manage the current session.
 
 ```tsx {{ filename: 'example.tsx' }}
 export default function Example() {
diff --git a/docs/_partials/nextjs/next-steps.mdx b/docs/_partials/nextjs/next-steps.mdx
@@ -15,7 +15,7 @@
   ---
 
   - [Read user and session data](/docs/nextjs/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your Next.js app.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your Next.js app.
 
   ---
 
diff --git a/docs/getting-started/quickstart.astro.mdx b/docs/getting-started/quickstart.astro.mdx
@@ -201,7 +201,7 @@ sdk: astro
   ---
 
   - [Read session and user data](/docs/astro/guides/users/reading)
-  - Learn how to use Clerk's stores and helpers to access the active session and user data in your Astro app.
+  - Learn how to use Clerk's stores and helpers to access the session and user data in your Astro app.
 
   ---
 
diff --git a/docs/getting-started/quickstart.nuxt.mdx b/docs/getting-started/quickstart.nuxt.mdx
@@ -149,7 +149,7 @@ Learn more about Clerk components, how to customize them, and how to use Clerk's
   ---
 
   - [Read session and user data](/docs/nuxt/guides/users/reading)
-  - Learn how to use Clerk's composables and helpers to access the active session and user data in your Nuxt app.
+  - Learn how to use Clerk's composables and helpers to access the session and user data in your Nuxt app.
 
   ---
 
diff --git a/docs/getting-started/quickstart.react-router.mdx b/docs/getting-started/quickstart.react-router.mdx
@@ -229,7 +229,7 @@ This tutorial assumes that you're using React Router **v7.1.2 or later** in fram
   ---
 
   - [Read session and user data](/docs/react-router/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your React Router app.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your React Router app.
 
   ---
 
diff --git a/docs/getting-started/quickstart.remix.mdx b/docs/getting-started/quickstart.remix.mdx
@@ -275,7 +275,7 @@ Learn how to use Clerk to quickly and easily add secure authentication and user
   ---
 
   - [Read user and session data](/docs/remix/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your Remix app.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your Remix app.
 
   ---
 
diff --git a/docs/getting-started/quickstart.tanstack-react-start.mdx b/docs/getting-started/quickstart.tanstack-react-start.mdx
@@ -252,7 +252,7 @@ sdk: tanstack-react-start
   ---
 
   - [Read user and session data](/docs/tanstack-react-start/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your TanStack React Start app.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your TanStack React Start app.
 
   ---
 
diff --git a/docs/getting-started/quickstart.vue.mdx b/docs/getting-started/quickstart.vue.mdx
@@ -98,7 +98,7 @@ This tutorial assumes that you're using [Vue 3](https://vuejs.org/) with [TypeSc
 
   ### Add `clerkPlugin` to your app
 
-  `clerkPlugin` provides active session and user context to Clerk's components and composables. It's required to pass your Clerk Publishable Key as an option. You can add an `if` statement to check that the key is imported properly. This prevents the app from running without the Publishable Key and catches TypeScript errors.
+  `clerkPlugin` provides session and user context to Clerk's components and composables. It's required to pass your Clerk Publishable Key as an option. You can add an `if` statement to check that the key is imported properly. This prevents the app from running without the Publishable Key and catches TypeScript errors.
 
   The `clerkPlugin` accepts optional options, such as `{ signInForceRedirectUrl: '/dashboard' }`. See the [reference documentation](/docs/reference/vue/clerk-plugin) for more information.
 
diff --git a/docs/guides/development/custom-flows/authentication/multi-session-applications.mdx b/docs/guides/development/custom-flows/authentication/multi-session-applications.mdx
@@ -24,30 +24,30 @@ To enable multi-session in your application, you need to configure it in the Cle
 1. Toggle on **Multi-session handling**.
 1. Select **Save changes**.
 
-## Get the active session and user
+## Get the session and user
 
 <CodeBlockTabs options={["React", "JavaScript", "iOS"]}>
   ```jsx
   import { useClerk } from '@clerk/clerk-react'
 
-  // Get the active session and user
+  // Get the session and user
   const { session, user } = useClerk()
   ```
 
   ```js
-  // Get the active session
-  const activeSession = window.Clerk.session
+  // Get the session
+  const currentSession = window.Clerk.session
 
-  // Get the active user
-  const activeUser = window.Clerk.user
+  // Get the user
+  const currentUser = window.Clerk.user
   ```
 
   ```swift
-  // Get the active session
-  var activeSession: Session? { Clerk.shared.session }
+  // Get the current session
+  var currentSession: Session? { Clerk.shared.session }
 
-  // Get the active user
-  var user: User? { Clerk.shared.user }
+  // Get the current user
+  var currentUser: User? { Clerk.shared.user }
   ```
 </CodeBlockTabs>
 
@@ -63,7 +63,7 @@ To enable multi-session in your application, you need to configure it in the Cle
   const availableSessions = client.sessions
   const currentSession = availableSessions[0].id
 
-  // Use setActive to set the current session.
+  // Use setActive() to set the session as active
   await setActive({
     session: currentSession.id,
     navigate: async ({ session }) => {
@@ -83,7 +83,7 @@ To enable multi-session in your application, you need to configure it in the Cle
   // You can get all the available sessions through the client
   const availableSessions = window.Clerk.client.sessions
 
-  // Use setActive to set the active session.
+  // Use setActive() to set the session as active
   await window.Clerk.setActive({
     session: availableSessions[0].id,
     navigate: async ({ session }) => {
@@ -103,7 +103,7 @@ To enable multi-session in your application, you need to configure it in the Cle
   // You can get all the available sessions through the client
   var availableSessions: [Session] { Clerk.shared.client?.sessions ?? [] }
 
-  // Use setActive to set the active session.
+  // Use setActive() to set the session as active
   try await Clerk.shared.setActive(sessionId: session.id)
   ```
 </CodeBlockTabs>
@@ -159,11 +159,11 @@ Use [`signOut()`](/docs/reference/javascript/clerk#sign-out) to deactivate a spe
   ```
 
   ```js
-  // Get the active session
-  const activeSession = window.Clerk.session
+  // Get the current session
+  const currentSession = window.Clerk.session
 
   // Use signOut to sign-out the active session
-  await window.Clerk.signOut(activeSession.id)
+  await window.Clerk.signOut(currentSession.id)
   ```
 
   ```swift
diff --git a/docs/guides/development/custom-sign-in-or-up-page.mdx b/docs/guides/development/custom-sign-in-or-up-page.mdx
@@ -103,7 +103,7 @@ To set up separate sign-in and sign-up pages, follow this guide, and then follow
   ---
 
   - [Read user and session data](/docs/nextjs/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your Next.js application.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your Next.js application.
 
   ---
 
diff --git a/docs/guides/development/custom-sign-in-or-up-page.remix.mdx b/docs/guides/development/custom-sign-in-or-up-page.remix.mdx
@@ -95,5 +95,5 @@ To set up separate sign-in and sign-up pages, follow this guide, and then follow
   ---
 
   - [Read user and session data](/docs/remix/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your Remix application.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your Remix application.
 </Cards>
diff --git a/docs/guides/development/custom-sign-in-or-up-page.tanstack-react-start.mdx b/docs/guides/development/custom-sign-in-or-up-page.tanstack-react-start.mdx
@@ -73,5 +73,5 @@ To set up separate sign-in and sign-up pages, follow this guide, and then follow
   ---
 
   - [Read user and session data](/docs/tanstack-react-start/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your TanStack React Start application.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your TanStack React Start application.
 </Cards>
diff --git a/docs/guides/development/custom-sign-up-page.mdx b/docs/guides/development/custom-sign-up-page.mdx
@@ -101,7 +101,7 @@ To set up a single sign-in-or-up page, follow the [custom sign-in-or-up page gui
 
 <Cards>
   - [Read user and session data](/docs/nextjs/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your Next.js application.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your Next.js application.
 
   ---
 
diff --git a/docs/guides/development/custom-sign-up-page.remix.mdx b/docs/guides/development/custom-sign-up-page.remix.mdx
@@ -90,5 +90,5 @@ To set up a single sign-in-or-up page, follow the [custom sign-in-or-up page gui
 
 <Cards>
   - [Read user and session data](/docs/remix/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your Remix application.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your Remix application.
 </Cards>
diff --git a/docs/guides/development/custom-sign-up-page.tanstack-react-start.mdx b/docs/guides/development/custom-sign-up-page.tanstack-react-start.mdx
@@ -68,5 +68,5 @@ To set up a single sign-in-or-up page, follow the [custom sign-in-or-up page gui
 
 <Cards>
   - [Read user and session data](/docs/tanstack-react-start/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your TanStack React Start application.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your TanStack React Start application.
 </Cards>
diff --git a/docs/guides/users/reading.expo.mdx b/docs/guides/users/reading.expo.mdx
@@ -12,7 +12,7 @@ This guide demonstrates how to use the `useAuth()` and `useUser()` hooks to prot
 
 {/* TODO: Keep in sync with _partials/hooks/use-auth */}
 
-The [`useAuth()`](/docs/reference/hooks/use-auth){{ target: '_blank' }} hook provides information about the current auth state, as well as helper methods to manage the current active session.
+The [`useAuth()`](/docs/reference/hooks/use-auth){{ target: '_blank' }} hook provides information about the current auth state, as well as helper methods to manage the current session.
 
 The following example demonstrates how to use the available properties of the `useAuth()` hook.
 
diff --git a/docs/guides/users/reading.nuxt.mdx b/docs/guides/users/reading.nuxt.mdx
@@ -1,6 +1,6 @@
 ---
 title: Read session and user data in your Nuxt app with Clerk
-description: Learn how to use Clerk's composables to access the active session and user data in your Nuxt application.
+description: Learn how to use Clerk's composables to access the session and user data in your Nuxt application.
 sdk: nuxt
 ---
 
diff --git a/docs/guides/users/reading.react-router.mdx b/docs/guides/users/reading.react-router.mdx
@@ -4,7 +4,7 @@ description: Learn how to use Clerk's hooks and helpers to protect content and a
 sdk: react-router
 ---
 
-Clerk provides a set of [hooks and helpers](/docs/reference/react-router/overview#client-side-helpers) that you can use to access the active session and user data in your React Router application. This guide demonstrates how to use these helpers in both the client and server-side to get you started.
+Clerk provides a set of [hooks and helpers](/docs/reference/react-router/overview#client-side-helpers) that you can use to access the session and user data in your React Router application. This guide demonstrates how to use these helpers in both the client and server-side to get you started.
 
 ## Server-side
 
@@ -112,7 +112,7 @@ export default function ProfileForm({ actionData }: Route.ComponentProps) {
 
 ## Client-side
 
-To access active session and user data on the client-side, you can use the `useAuth()` and `useUser()` hooks.
+To access session and user data on the client-side, you can use the `useAuth()` and `useUser()` hooks.
 
 ### `useAuth()`
 
diff --git a/docs/guides/users/reading.remix.mdx b/docs/guides/users/reading.remix.mdx
@@ -1,12 +1,12 @@
 ---
 title: Read session and user data in your Remix app with Clerk
-description: Learn how to use Clerk's hooks and helpers to access the active session and user data in your Remix application.
+description: Learn how to use Clerk's hooks and helpers to access the session and user data in your Remix application.
 sdk: remix
 ---
 
 <Include src="_partials/remix/maintenance-mode" />
 
-Clerk provides a set of [hooks and helpers](/docs/reference/remix/overview) that you can use to access the active session and user data in your Remix application. Here are examples of how to use these helpers in both the client and server-side to get you started.
+Clerk provides a set of [hooks and helpers](/docs/reference/remix/overview) that you can use to access the session and user data in your Remix application. Here are examples of how to use these helpers in both the client and server-side to get you started.
 
 ## Server-side
 
diff --git a/docs/guides/users/reading.tanstack-react-start.mdx b/docs/guides/users/reading.tanstack-react-start.mdx
@@ -1,10 +1,10 @@
 ---
 title: Read session and user data in your TanStack React Start app with Clerk
-description: Learn how to use Clerk's hooks and helpers to access the active session and user data in your TanStack React Start application.
+description: Learn how to use Clerk's hooks and helpers to access the session and user data in your TanStack React Start application.
 sdk: tanstack-react-start
 ---
 
-Clerk provides a set of [hooks and helpers](/docs/reference/tanstack-react-start/overview#client-side-helpers) that you can use to access the active session and user data in your TanStack React Start application. Here are examples of how to use these helpers in both the client and server-side to get you started.
+Clerk provides a set of [hooks and helpers](/docs/reference/tanstack-react-start/overview#client-side-helpers) that you can use to access the session and user data in your TanStack React Start application. Here are examples of how to use these helpers in both the client and server-side to get you started.
 
 ## Server-side
 
@@ -93,13 +93,13 @@ In the following example, the `userId` is passed to the JS Backend SDK's `getUse
 
 ## Client-side
 
-To access active session and user data on the client-side, use Clerk's `useAuth()` and `useUser()` hooks.
+To access session and user data on the client-side, use Clerk's `useAuth()` and `useUser()` hooks.
 
 ### `useAuth()`
 
 {/* TODO: Keep in sync with _partials/hooks/use-auth */}
 
-The [`useAuth()`](/docs/reference/hooks/use-auth){{ target: '_blank' }} hook provides information about the current auth state, as well as helper methods to manage the current active session.
+The [`useAuth()`](/docs/reference/hooks/use-auth){{ target: '_blank' }} hook provides information about the current auth state, as well as helper methods to manage the current session.
 
 ```tsx {{ filename: 'routes/example.tsx' }}
 import { useAuth } from '@clerk/tanstack-react-start'
diff --git a/docs/reference/astro/client-side-helpers/auth-store.mdx b/docs/reference/astro/client-side-helpers/auth-store.mdx
@@ -1,10 +1,10 @@
 ---
 title: '`$authStore`'
-description: Clerk's $authStore nanostore provides a convenient way to access the current auth state and helper methods for managing the active session.
+description: Clerk's $authStore nanostore provides a convenient way to access the current auth state and helper methods for managing the session.
 sdk: astro
 ---
 
-The `$authStore` store provides a convenient way to access the current auth state and helper methods for managing the active session.
+The `$authStore` store provides a convenient way to access the current auth state and helper methods for managing the session.
 
 ## Returns
 
diff --git a/docs/reference/astro/client-side-helpers/session-store.mdx b/docs/reference/astro/client-side-helpers/session-store.mdx
@@ -1,6 +1,6 @@
 ---
 title: '`$sessionStore`'
-description: Clerk's $sessionStore nanostore provides a convenient way to access the current user Session object, as well as helpers to set the active session.
+description: Clerk's $sessionStore nanostore provides a convenient way to access the current user Session object, as well as helpers to set the session.
 sdk: astro
 ---
 
diff --git a/docs/reference/astro/react.mdx b/docs/reference/astro/react.mdx
@@ -128,7 +128,7 @@ If you have not set up your Astro application to work with Clerk, see the [quick
 
 <Cards>
   - [Read user and session data](/docs/astro/guides/users/reading)
-  - Learn how to use Clerk's hooks and helpers to access the active session and user data in your Astro application.
+  - Learn how to use Clerk's hooks and helpers to access the session and user data in your Astro application.
 
   ---
 
diff --git a/docs/reference/components/control/signed-in.mdx b/docs/reference/components/control/signed-in.mdx
@@ -6,7 +6,7 @@ sdk: astro, chrome-extension, expo, nextjs, nuxt, react, react-router, remix, ta
 
 ## Overview
 
-The `<SignedIn>` component offers authentication checks as a cross-cutting concern. Any children components wrapped by a `<SignedIn>` component will be rendered only if there's a User with an active Session signed in your application.
+The `<SignedIn>` component offers authentication checks as a cross-cutting concern. Any children components wrapped by a `<SignedIn>` component will be rendered only if there's a user with an active session signed in your application.
 
 > [!CAUTION]
 > This component only **visually hides** its children when the current user is not authenticated. The contents of its children remain accessible via the browser's source code even if the user fails the authentication check. Do not use this component to hide sensitive information that should be completely inaccessible to unauthorized users. For truly sensitive data, perform [authorization checks](/docs/guides/secure/authorization-checks) on the server before sending the data to the client.
diff --git a/docs/reference/composables/use-auth.mdx b/docs/reference/composables/use-auth.mdx
@@ -4,7 +4,7 @@ description: Access and manage authentication state in your Vue application with
 sdk: vue, nuxt
 ---
 
-The `useAuth()` composable provides access to the current user's authentication state and methods to manage the active session in your Vue application.
+The `useAuth()` composable provides access to the current user's authentication state and methods to manage the session in your Vue application.
 
 ## Returns
 
diff --git a/docs/reference/composables/use-session.mdx b/docs/reference/composables/use-session.mdx
@@ -26,7 +26,7 @@ The `useSession()` composable provides access to the current user's [`Session`](
   - `session`
   - <code>Ref\<[Session](/docs/reference/javascript/session)></code>
 
-  Holds the current active session for the user.
+  The current session for the user.
 </Properties>
 
 ## How to use the `useSession()` composable
diff --git a/docs/reference/javascript/clerk.mdx b/docs/reference/javascript/clerk.mdx
@@ -61,7 +61,7 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package
   - `session`
   - <code>[Session][session-ref] | null | undefined</code>
 
-  The currently active `Session`, which is guaranteed to be one of the sessions in `Client.sessions`. If there is no active session, this field will be `null`. If the session is loading, this field will be `undefined`.
+  The current `Session`, which is guaranteed to be one of the sessions in `Client.sessions`. If there is no current session, this field will be `null`. If the session is loading, this field will be `undefined`.
 
   ---
 
diff --git a/scripts/build-docs.ts b/scripts/build-docs.ts
@@ -292,6 +292,7 @@ async function main() {
         'types/active-session-resource.mdx': ['link-doc-not-found', 'link-hash-not-found'],
         'types/organization-custom-role-key.mdx': ['link-doc-not-found'],
         'types/pending-session-resource.mdx': ['link-doc-not-found', 'link-hash-not-found'],
+        'types/billing-checkout-resource.mdx': ['link-doc-not-found'],
       },
       partials: {},
       tooltips: {},
