clerk · nikosdouvlis · Dec 8, 2025 · Dec 8, 2025 · Dec 8, 2025 · Dec 8, 2025
diff --git a/.changeset/spotty-terms-check.md b/.changeset/spotty-terms-check.md
@@ -0,0 +1,7 @@
+---
+'@clerk/localizations': minor
+'@clerk/clerk-js': minor
+'@clerk/shared': minor
+---
+
+Add a subtitle on the Reset password session task screen
diff --git a/...c/ui/components/SessionTasks/tasks/TaskResetPassword/__tests__/TaskResetPassword.test.tsx b/...c/ui/components/SessionTasks/tasks/TaskResetPassword/__tests__/TaskResetPassword.test.tsx
@@ -53,7 +53,7 @@ describe('TaskResetPassword', () => {
 
     fixtures.clerk.user?.updatePassword.mockResolvedValue({});
     const { getByRole, userEvent, getByLabelText } = render(<TaskResetPassword />, { wrapper });
-    await waitFor(() => getByRole('heading', { name: /Reset password/i }));
+    await waitFor(() => getByRole('heading', { name: /Reset your password/i }));
 
     await userEvent.type(getByLabelText(/new password/i), 'testtest');
     await userEvent.type(getByLabelText(/confirm password/i), 'testtest');
@@ -73,7 +73,7 @@ describe('TaskResetPassword', () => {
       });
     });
     const { getByRole, getByTestId } = render(<TaskResetPassword />, { wrapper });
-    await waitFor(() => getByRole('heading', { name: /Reset password/i }));
+    await waitFor(() => getByRole('heading', { name: /Reset your password/i }));
 
     const identifierField = getByTestId('hidden-identifier');
     expect(identifierField).toHaveValue('test@clerk.com');

diff --git a/packages/clerk-js/src/ui/components/SessionTasks/tasks/TaskResetPassword/index.tsx b/packages/clerk-js/src/ui/components/SessionTasks/tasks/TaskResetPassword/index.tsx
@@ -112,6 +112,7 @@ const TaskResetPasswordInternal = () => {
           <Card.Content>
             <Header.Root showLogo>
               <Header.Title localizationKey={localizationKeys('taskResetPassword.title')} />
+              <Header.Subtitle localizationKey={localizationKeys('taskResetPassword.subtitle')} />
             </Header.Root>
             <Card.Alert>{card.error}</Card.Alert>
             <Col

diff --git a/packages/localizations/src/ar-SA.ts b/packages/localizations/src/ar-SA.ts
@@ -870,6 +870,7 @@ export const arSA: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/be-BY.ts b/packages/localizations/src/be-BY.ts
@@ -878,6 +878,7 @@ export const beBY: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/bg-BG.ts b/packages/localizations/src/bg-BG.ts
@@ -874,6 +874,7 @@ export const bgBG: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/bn-IN.ts b/packages/localizations/src/bn-IN.ts
@@ -878,6 +878,7 @@ export const bnIN: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/ca-ES.ts b/packages/localizations/src/ca-ES.ts
@@ -873,6 +873,7 @@ export const caES: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/cs-CZ.ts b/packages/localizations/src/cs-CZ.ts
@@ -884,6 +884,7 @@ export const csCZ: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/da-DK.ts b/packages/localizations/src/da-DK.ts
@@ -871,6 +871,7 @@ export const daDK: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/de-DE.ts b/packages/localizations/src/de-DE.ts
@@ -888,6 +888,7 @@ export const deDE: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/el-GR.ts b/packages/localizations/src/el-GR.ts
@@ -875,6 +875,7 @@ export const elGR: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/en-GB.ts b/packages/localizations/src/en-GB.ts
@@ -875,6 +875,7 @@ export const enGB: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/en-US.ts b/packages/localizations/src/en-US.ts
@@ -872,7 +872,8 @@ export const enUS: LocalizationResource = {
       actionLink: 'Sign out',
       actionText: 'Signed in as {{identifier}}',
     },
-    title: 'Reset password',
+    subtitle: 'Your account requires a new password before you can continue',
+    title: 'Reset your password',
   },
   unstable__errors: {
     already_a_member_in_organization: '{{email}} is already a member of the organization.',

diff --git a/packages/localizations/src/es-CR.ts b/packages/localizations/src/es-CR.ts
@@ -880,6 +880,7 @@ export const esCR: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/es-ES.ts b/packages/localizations/src/es-ES.ts
@@ -874,6 +874,7 @@ export const esES: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/es-MX.ts b/packages/localizations/src/es-MX.ts
@@ -881,6 +881,7 @@ export const esMX: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/es-UY.ts b/packages/localizations/src/es-UY.ts
@@ -880,6 +880,7 @@ export const esUY: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/fa-IR.ts b/packages/localizations/src/fa-IR.ts
@@ -884,6 +884,7 @@ export const faIR: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/fi-FI.ts b/packages/localizations/src/fi-FI.ts
@@ -874,6 +874,7 @@ export const fiFI: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/fr-FR.ts b/packages/localizations/src/fr-FR.ts
@@ -889,6 +889,7 @@ export const frFR: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/he-IL.ts b/packages/localizations/src/he-IL.ts
@@ -864,6 +864,7 @@ export const heIL: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/hi-IN.ts b/packages/localizations/src/hi-IN.ts
@@ -878,6 +878,7 @@ export const hiIN: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/hr-HR.ts b/packages/localizations/src/hr-HR.ts
@@ -875,6 +875,7 @@ export const hrHR: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/hu-HU.ts b/packages/localizations/src/hu-HU.ts
@@ -872,6 +872,7 @@ export const huHU: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/id-ID.ts b/packages/localizations/src/id-ID.ts
@@ -879,6 +879,7 @@ export const idID: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/is-IS.ts b/packages/localizations/src/is-IS.ts
@@ -875,6 +875,7 @@ export const isIS: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/it-IT.ts b/packages/localizations/src/it-IT.ts
@@ -881,6 +881,7 @@ export const itIT: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/ja-JP.ts b/packages/localizations/src/ja-JP.ts
@@ -885,6 +885,7 @@ export const jaJP: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/kk-KZ.ts b/packages/localizations/src/kk-KZ.ts
@@ -865,6 +865,7 @@ export const kkKZ: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/ko-KR.ts b/packages/localizations/src/ko-KR.ts
@@ -866,6 +866,7 @@ export const koKR: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/mn-MN.ts b/packages/localizations/src/mn-MN.ts
@@ -873,6 +873,7 @@ export const mnMN: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/ms-MY.ts b/packages/localizations/src/ms-MY.ts
@@ -881,6 +881,7 @@ export const msMY: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/nb-NO.ts b/packages/localizations/src/nb-NO.ts
@@ -872,6 +872,7 @@ export const nbNO: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/nl-BE.ts b/packages/localizations/src/nl-BE.ts
@@ -873,6 +873,7 @@ export const nlBE: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/nl-NL.ts b/packages/localizations/src/nl-NL.ts
@@ -873,6 +873,7 @@ export const nlNL: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/pl-PL.ts b/packages/localizations/src/pl-PL.ts
@@ -878,6 +878,7 @@ export const plPL: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/pt-BR.ts b/packages/localizations/src/pt-BR.ts
@@ -885,6 +885,7 @@ export const ptBR: LocalizationResource = {
       actionLink: 'Sair',
       actionText: 'Conectado como {{identifier}}',
     },
+    subtitle: undefined,
     title: 'Resetar senha',
   },
   unstable__errors: {

diff --git a/packages/localizations/src/pt-PT.ts b/packages/localizations/src/pt-PT.ts
@@ -871,6 +871,7 @@ export const ptPT: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/ro-RO.ts b/packages/localizations/src/ro-RO.ts
@@ -886,6 +886,7 @@ export const roRO: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/ru-RU.ts b/packages/localizations/src/ru-RU.ts
@@ -885,6 +885,7 @@ export const ruRU: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/sk-SK.ts b/packages/localizations/src/sk-SK.ts
@@ -878,6 +878,7 @@ export const skSK: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/sr-RS.ts b/packages/localizations/src/sr-RS.ts
@@ -871,6 +871,7 @@ export const srRS: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/sv-SE.ts b/packages/localizations/src/sv-SE.ts
@@ -876,6 +876,7 @@ export const svSE: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/ta-IN.ts b/packages/localizations/src/ta-IN.ts
@@ -880,6 +880,7 @@ export const taIN: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/te-IN.ts b/packages/localizations/src/te-IN.ts
@@ -880,6 +880,7 @@ export const teIN: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/th-TH.ts b/packages/localizations/src/th-TH.ts
@@ -874,6 +874,7 @@ export const thTH: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {

diff --git a/packages/localizations/src/tr-TR.ts b/packages/localizations/src/tr-TR.ts
@@ -874,6 +874,7 @@ export const trTR: LocalizationResource = {
       actionLink: undefined,
       actionText: undefined,
     },
+    subtitle: undefined,
     title: undefined,
   },
   unstable__errors: {