feat(ui): Add Google Workspace SAML to self-serve SSO by LauraBeatris · Pull Request #8690 · clerk/javascript

LauraBeatris · 2026-05-28T15:01:04Z

Description

Introduces Google Workspace SAML provider with tailored configure steps

CleanShot.2026-05-28.at.14.28.17.mp4

Unrelated changes/fixes

Update stepper line-height to fix alignment issue
Update test runs query to not refetch on window focus, which was causing the 'Refresh logs' button to display a spinner on mount

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

vercel · 2026-05-28T15:01:07Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jun 1, 2026 7:42pm

changeset-bot · 2026-05-28T15:01:18Z

🦋 Changeset detected

Latest commit: 3ba2066

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 20 packages

Name	Type
@clerk/localizations	Patch
@clerk/shared	Patch
@clerk/ui	Patch
@clerk/react	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-js	Patch
@clerk/expo-passkeys	Patch
@clerk/expo	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/vue	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

pkg-pr-new · 2026-05-28T15:04:09Z

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@8690

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@8690

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@8690

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@8690

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@8690

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@8690

@clerk/express

npm i https://pkg.pr.new/@clerk/express@8690

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@8690

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@8690

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@8690

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@8690

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@8690

@clerk/react

npm i https://pkg.pr.new/@clerk/react@8690

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@8690

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@8690

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@8690

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@8690

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@8690

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@8690

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@8690

commit: 3ba2066

github-actions · 2026-05-28T17:33:05Z

API Changes Report

Generated by snapi on 2026-05-28T17:33:02.523Z

Summary

Metric	Count
Packages analyzed	6
Packages with changes	1
🔴 Breaking changes	0
🟡 Non-breaking changes	2
🟢 Additions	0

🤖 This report was reviewed by claude-sonnet-4-6.

@clerk/shared

Current version: 4.14.0
Recommended bump: MINOR → 4.15.0

Subpath `./types`

🟡 Non-breaking Changes (2)

Modified: `__internal_LocalizationResource`

Diff (before: 1680 lines, after: 1783 lines). Click to expand.

// ... 1215 unchanged lines elided ...
groupLabel: LocalizationValue;
okta: LocalizationValue;
customSaml: LocalizationValue;
+ google: LocalizationValue;
};
warning: LocalizationValue;
};
verifyEmailDomainStep: {
title: LocalizationValue;
subtitle: LocalizationValue;
addEmailAddress: {
formTitle: LocalizationValue;
formSubtitle: LocalizationValue;
inputPlaceholder: LocalizationValue;
inputLabel: LocalizationValue;
};
emailCode: {
formTitle: LocalizationValue;
formSubtitle: LocalizationValue<'identifier'>;
resendButton: LocalizationValue;
verified: {
title: LocalizationValue;
subtitle: LocalizationValue;
inputLabel: LocalizationValue;
};
};
domainTaken: {
title: LocalizationValue<'domain'>;
subtitle: LocalizationValue;
};
};
testConfigurationStep: {
title: LocalizationValue;
subtitle: LocalizationValue;
error__noSuccessfulTestRun: LocalizationValue;
testUrl: {
actionLabel__open: LocalizationValue;
};
testResults: {
title: LocalizationValue;
actionLabel__refresh: LocalizationValue;
polling: LocalizationValue;
status__success: LocalizationValue;
status__failed: LocalizationValue;
status__pending: LocalizationValue;
empty: {
title: LocalizationValue;
subtitle: LocalizationValue;
};
};
testRunDetails: {
title: LocalizationValue;
runDetails: {
sectionTitle: LocalizationValue;
timestamp: LocalizationValue;
status: LocalizationValue;
errorCode: LocalizationValue;
fullMessage: LocalizationValue;
actionLabel__copy: LocalizationValue;
actionLabel__copied: LocalizationValue;
};
parsedUserInfo: {
sectionTitle: LocalizationValue;
email: LocalizationValue;
firstName: LocalizationValue;
};
howToFix: {
sectionTitle: LocalizationValue;
actionLabel__viewDocumentation: LocalizationValue;
saml_user_attribute_missing: {
intro: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
step3: LocalizationValue;
};
saml_response_relaystate_missing: {
description: LocalizationValue;
};
saml_email_address_domain_mismatch: {
description: LocalizationValue;
};
oauth_access_denied: {
description: LocalizationValue;
};
oauth_token_exchange_error: {
description: LocalizationValue;
};
oauth_fetch_user_error: {
intro: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
};
};
};
};
configureStep: {
attributeMappingTable: {
badges: {
required: LocalizationValue;
optional: LocalizationValue;
};
};
samlOkta: {
mainHeaderTitle: LocalizationValue;
createAppStep: {
headerSubtitle: LocalizationValue;
createAppInstructions: {
title: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
step3: LocalizationValue;
step4: LocalizationValue;
step5: LocalizationValue;
};
serviceProviderInstructions: {
title: LocalizationValue;
paragraph1: LocalizationValue;
paragraph2: LocalizationValue;
serviceProviderFields: {
acsUrl: {
label: LocalizationValue;
};
spEntityId: {
label: LocalizationValue;
};
};
};
completeSamlIntegrationInstructions: {
title: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
};
};
attributeMappingStep: {
headerSubtitle: LocalizationValue;
paragraph: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
attributeMappingTable: {
columns: {
name: LocalizationValue;
expression: LocalizationValue;
};
rows: {
email: {
name: LocalizationValue;
expression: LocalizationValue;
};
firstName: {
name: LocalizationValue;
expression: LocalizationValue;
};
lastName: {
name: LocalizationValue;
expression: LocalizationValue;
};
};
};
};
assignUsersStep: {
headerSubtitle: LocalizationValue;
assignUsersInstructions: {
title: LocalizationValue;
paragraph: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
step3: LocalizationValue;
step4: LocalizationValue;
step5: LocalizationValue;
};
};
identityProviderMetadataStep: {
headerSubtitle: LocalizationValue;
modes: {
title: LocalizationValue;
ariaLabel: LocalizationValue;
metadataUrl: LocalizationValue;
manual: LocalizationValue;
};
metadataUrl: {
label: LocalizationValue;
placeholder: LocalizationValue;
description: LocalizationValue;
};
manual: {
description: LocalizationValue;
signOnUrl: {
label: LocalizationValue;
placeholder: LocalizationValue;
};
issuer: {
label: LocalizationValue;
placeholder: LocalizationValue;
};
signingCertificate: {
label: LocalizationValue;
uploadFile: LocalizationValue;
replaceFile: LocalizationValue;
removeFile: LocalizationValue;
fileUploaded: LocalizationValue;
};
};
};
};
samlCustom: {
mainHeaderTitle: LocalizationValue;
createAppStep: {
headerSubtitle: LocalizationValue;
createAppInstructions: {
title: LocalizationValue;
paragraph: LocalizationValue;
};
serviceProviderFields: {
acsUrl: {
label: LocalizationValue;
};
spEntityId: {
label: LocalizationValue;
};
};
};
attributeMappingStep: {
headerSubtitle: LocalizationValue;
paragraph: LocalizationValue;
attributeMappingTable: {
title: LocalizationValue;
columns: {
userProfile: LocalizationValue;
attributeName: LocalizationValue;
};
rows: {
email: {
userProfile: LocalizationValue;
attributeName: LocalizationValue;
};
firstName: {
userProfile: LocalizationValue;
attributeName: LocalizationValue;
};
lastName: {
userProfile: LocalizationValue;
attributeName: LocalizationValue;
};
};
};
};
assignUsersStep: {
headerSubtitle: LocalizationValue;
title: LocalizationValue;
paragraph: LocalizationValue;
};
identityProviderMetadataStep: {
headerSubtitle: LocalizationValue;
modes: {
title: LocalizationValue;
ariaLabel: LocalizationValue;
metadataUrl: LocalizationValue;
manual: LocalizationValue;
};
metadataUrl: {
label: LocalizationValue;
placeholder: LocalizationValue;
+ description: LocalizationValue;+ };+ manual: {+ description: LocalizationValue;+ signOnUrl: {+ label: LocalizationValue;+ placeholder: LocalizationValue;+ };+ issuer: {+ label: LocalizationValue;+ placeholder: LocalizationValue;+ };+ signingCertificate: {+ label: LocalizationValue;+ uploadFile: LocalizationValue;+ replaceFile: LocalizationValue;+ removeFile: LocalizationValue;+ fileUploaded: LocalizationValue;+ };+ };+ };+ };+ samlGoogle: {+ mainHeaderTitle: LocalizationValue;+ createAppStep: {+ headerSubtitle: LocalizationValue;+ createAppInstructions: {+ title: LocalizationValue;+ step1: LocalizationValue;+ step2: LocalizationValue;+ step3: LocalizationValue;+ step4: LocalizationValue;+ step5: LocalizationValue;+ };+ };+ identityProviderMetadataStep: {+ headerSubtitle: LocalizationValue;+ modes: {+ title: LocalizationValue;+ ariaLabel: LocalizationValue;+ metadataFile: LocalizationValue;+ manual: LocalizationValue;+ };+ metadataFile: {+ label: LocalizationValue;
description: LocalizationValue;
+ uploadFile: LocalizationValue;+ replaceFile: LocalizationValue;+ removeFile: LocalizationValue;+ fileUploaded: LocalizationValue;
};
manual: {
description: LocalizationValue;
signOnUrl: {
label: LocalizationValue;
placeholder: LocalizationValue;
};
issuer: {
label: LocalizationValue;
placeholder: LocalizationValue;
};
signingCertificate: {
label: LocalizationValue;
uploadFile: LocalizationValue;
replaceFile: LocalizationValue;
removeFile: LocalizationValue;
fileUploaded: LocalizationValue;
+ };+ };+ };+ serviceProviderStep: {+ headerSubtitle: LocalizationValue;+ title: LocalizationValue;+ paragraph: LocalizationValue;+ serviceProviderFields: {+ acsUrl: {+ label: LocalizationValue;+ };+ spEntityId: {+ label: LocalizationValue;+ };+ };+ nameIdInstructions: {+ step1: LocalizationValue;+ step2: LocalizationValue;+ };+ };+ attributeMappingStep: {+ headerSubtitle: LocalizationValue;+ paragraph: LocalizationValue;+ step1: LocalizationValue;+ step2: LocalizationValue;+ attributeMappingTable: {+ columns: {+ googleAttribute: LocalizationValue;+ appAttribute: LocalizationValue;+ };+ rows: {+ email: {+ googleAttribute: LocalizationValue;+ appAttribute: LocalizationValue;+ };+ firstName: {+ googleAttribute: LocalizationValue;+ appAttribute: LocalizationValue;+ };+ lastName: {+ googleAttribute: LocalizationValue;+ appAttribute: LocalizationValue;+ };
};
+ };+ };+ configureUserAccess: {+ headerSubtitle: LocalizationValue;+ assignUsersInstructions: {+ paragraph1: LocalizationValue;+ step1: LocalizationValue;+ step2: LocalizationValue;+ step3: LocalizationValue;+ paragraph2: LocalizationValue;
};
};
};
// ... 182 unchanged lines elided ...

Static analyzer: Breaking change in type alias __internal_LocalizationResource: Type changed: {locale:string;maintenanceMode:LocalizationValue;roles:{[r:string]:LocalizationValue;};socialButtonsBlockButton:Localiz… → {locale:string;maintenanceMode:LocalizationValue;roles:{[r:string]:LocalizationValue;};socialButtonsBlockButton:Localiz…

🤖 AI review (reclassified as non-breaking) (85%): The __internal_LocalizationResource type had new fields added to it (e.g., configureSSO.selectProviderStep.saml.google, configureSSO.configureStep.samlGoogle, and other nested additions). This type is used as an input/source for LocalizationResource (via DeepPartial<DeepLocalizationWithoutObjects<__internal_LocalizationResource>>), meaning consumers providing localization objects only need to supply a subset. Adding new optional keys to the shape is non-breaking for existing consumers. However, the rule-based analyzer flagged it as breaking. Since LocalizationResource extends DeepPartial<...>, existing consumer code that provides a partial localization object would still compile fine with the additions.

Modified: `FieldId`

- type FieldId = 'firstName' | 'lastName' | 'name' | 'slug' | 'emailAddress' | 'phoneNumber' | 'currentPassword' | 'newPassword' | 'signOutOfOtherSessions' | 'passkeyName' | 'password' | 'confirmPassword' | 'identifier' | 'username' | 'code' | 'role' | 'deleteConfirmation' | 'deleteOrganizationConfirmation' | 'enrollmentMode' | 'affiliationEmailAddress' | 'deleteExistingInvitationsSuggestions' | 'legalAccepted' | 'apiKeyDescription' | 'apiKeyExpirationDate' | 'apiKeyRevokeConfirmation' | 'apiKeySecret' | 'idpCertificate' | 'idpEntityId' | 'idpMetadataUrl' | 'idpSsoUrl' | 'acsUrl' | 'spEntityId' | 'web3WalletName';+ type FieldId = 'firstName' | 'lastName' | 'name' | 'slug' | 'emailAddress' | 'phoneNumber' | 'currentPassword' | 'newPassword' | 'signOutOfOtherSessions' | 'passkeyName' | 'password' | 'confirmPassword' | 'identifier' | 'username' | 'code' | 'role' | 'deleteConfirmation' | 'deleteOrganizationConfirmation' | 'enrollmentMode' | 'affiliationEmailAddress' | 'deleteExistingInvitationsSuggestions' | 'legalAccepted' | 'apiKeyDescription' | 'apiKeyExpirationDate' | 'apiKeyRevokeConfirmation' | 'apiKeySecret' | 'idpCertificate' | 'idpEntityId' | 'idpMetadata' | 'idpMetadataUrl' | 'idpSsoUrl' | 'acsUrl' | 'spEntityId' | 'web3WalletName';

Static analyzer: Breaking change in type alias FieldId: Type changed: 'firstName'|'lastName'|'name'|'slug'|'emailAddress'|'phoneNumber'|'currentPassword'|'newPassword'|'signOutOfOtherSessio… → 'firstName'|'lastName'|'name'|'slug'|'emailAddress'|'phoneNumber'|'currentPassword'|'newPassword'|'signOutOfOtherSessio…

🤖 AI review (reclassified as non-breaking) (80%): The FieldId type had 'idpMetadata' added as a new member to the union. FieldId is used internally as a field identifier type. Consumers who exhaustively switch over FieldId values (e.g., via a switch statement with no default) could be affected, but adding a new union member to a string union that is used as an identifier/label type is generally non-breaking for consumers that receive values of this type. Consumers who produce values typed as FieldId are unaffected since the new string is simply an additional valid value.

Report generated by snapi

github-actions · 2026-06-01T17:53:02Z

API Changes Report

Generated by Break Check on 2026-06-01T19:45:56.867Z

Summary

Metric	Count
Packages analyzed	19
Packages with changes	1
🔴 Breaking changes	2
🟡 Non-breaking changes	3
🟢 Additions	2

Warning
2 breaking change(s) detected - Major version bump required

🤖 This report was reviewed by claude-sonnet-4-6.

Note
Break Check could not snapshot 3 subpaths; the diff below excludes them.
@clerk/astro ./env: Internal Error: Unable to determine module for: /home/runner/_work/javascript/javascript/packages/astro/env.d.ts You have encountered a software defect. Please consider reporting the issue to the maintainers of this application.
@clerk/shared ./cookie: Internal Error: Unable to follow symbol for "Cookies" You have encountered a software defect. Please consider reporting the issue to the maintainers of this application.
@clerk/testing ./cypress: Symbol not found for identifier: Cypress

@clerk/shared

Current version: 4.14.0
Recommended bump: MAJOR → 5.0.0

Subpath `./apiUrlFromPublishableKey`

🟡 Non-breaking Changes (1)

Modified: `apiUrlFromPublishableKey`

- apiUrlFromPublishableKey: (publishableKey: string) => "https://api.lclclerk.com" | "https://api.clerkstage.dev" | "https://api.clerk.com"+ apiUrlFromPublishableKey: (publishableKey: string) => "https://api.clerk.com" | "https://api.lclclerk.com" | "https://api.clerkstage.dev"

Static analyzer: Breaking change in function apiUrlFromPublishableKey: Return type changed: "https://api.lclclerk.com"|"https://api.clerkstage.dev"|"https://api.clerk.com" → "https://api.clerk.com"|"https://api.lclclerk.com"|"https://api.clerkstage.dev"

🤖 AI review (reclassified as non-breaking) (95%): The union type members are identical in both versions — only their order differs. TypeScript union types are order-independent structurally, so no well-typed consumer code would break. A consumer checking returnValue === 'https://api.clerk.com' or exhaustively switching over the union members would behave identically.

Subpath `./index-Dq-_K2VH`

🟢 Additions (1)

Added: `./index-Dq-_K2VH`

New subpath export ./index-Dq-_K2VH (2781 exported members)

Subpath `./index-ZibUt-Ji`

🔴 Breaking Changes (1)

Changed: `./index-ZibUt-Ji`

Subpath export ./index-ZibUt-Ji was removed

Subpath `./types`

🟡 Non-breaking Changes (2)

Modified: `__internal_LocalizationResource`

Diff (before: 1680 lines, after: 1783 lines). Click to expand.

// ... 1215 unchanged lines elided ...
groupLabel: LocalizationValue;
okta: LocalizationValue;
customSaml: LocalizationValue;
+ google: LocalizationValue;
};
warning: LocalizationValue;
};
verifyEmailDomainStep: {
title: LocalizationValue;
subtitle: LocalizationValue;
addEmailAddress: {
formTitle: LocalizationValue;
formSubtitle: LocalizationValue;
inputPlaceholder: LocalizationValue;
inputLabel: LocalizationValue;
};
emailCode: {
formTitle: LocalizationValue;
formSubtitle: LocalizationValue<'identifier'>;
resendButton: LocalizationValue;
verified: {
title: LocalizationValue;
subtitle: LocalizationValue;
inputLabel: LocalizationValue;
};
};
domainTaken: {
title: LocalizationValue<'domain'>;
subtitle: LocalizationValue;
};
};
testConfigurationStep: {
title: LocalizationValue;
subtitle: LocalizationValue;
error__noSuccessfulTestRun: LocalizationValue;
testUrl: {
actionLabel__open: LocalizationValue;
};
testResults: {
title: LocalizationValue;
actionLabel__refresh: LocalizationValue;
polling: LocalizationValue;
status__success: LocalizationValue;
status__failed: LocalizationValue;
status__pending: LocalizationValue;
empty: {
title: LocalizationValue;
subtitle: LocalizationValue;
};
};
testRunDetails: {
title: LocalizationValue;
runDetails: {
sectionTitle: LocalizationValue;
timestamp: LocalizationValue;
status: LocalizationValue;
errorCode: LocalizationValue;
fullMessage: LocalizationValue;
actionLabel__copy: LocalizationValue;
actionLabel__copied: LocalizationValue;
};
parsedUserInfo: {
sectionTitle: LocalizationValue;
email: LocalizationValue;
firstName: LocalizationValue;
};
howToFix: {
sectionTitle: LocalizationValue;
actionLabel__viewDocumentation: LocalizationValue;
saml_user_attribute_missing: {
intro: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
step3: LocalizationValue;
};
saml_response_relaystate_missing: {
description: LocalizationValue;
};
saml_email_address_domain_mismatch: {
description: LocalizationValue;
};
oauth_access_denied: {
description: LocalizationValue;
};
oauth_token_exchange_error: {
description: LocalizationValue;
};
oauth_fetch_user_error: {
intro: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
};
};
};
};
configureStep: {
attributeMappingTable: {
badges: {
required: LocalizationValue;
optional: LocalizationValue;
};
};
samlOkta: {
mainHeaderTitle: LocalizationValue;
createAppStep: {
headerSubtitle: LocalizationValue;
createAppInstructions: {
title: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
step3: LocalizationValue;
step4: LocalizationValue;
step5: LocalizationValue;
};
serviceProviderInstructions: {
title: LocalizationValue;
paragraph1: LocalizationValue;
paragraph2: LocalizationValue;
serviceProviderFields: {
acsUrl: {
label: LocalizationValue;
};
spEntityId: {
label: LocalizationValue;
};
};
};
completeSamlIntegrationInstructions: {
title: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
};
};
attributeMappingStep: {
headerSubtitle: LocalizationValue;
paragraph: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
attributeMappingTable: {
columns: {
name: LocalizationValue;
expression: LocalizationValue;
};
rows: {
email: {
name: LocalizationValue;
expression: LocalizationValue;
};
firstName: {
name: LocalizationValue;
expression: LocalizationValue;
};
lastName: {
name: LocalizationValue;
expression: LocalizationValue;
};
};
};
};
assignUsersStep: {
headerSubtitle: LocalizationValue;
assignUsersInstructions: {
title: LocalizationValue;
paragraph: LocalizationValue;
step1: LocalizationValue;
step2: LocalizationValue;
step3: LocalizationValue;
step4: LocalizationValue;
step5: LocalizationValue;
};
};
identityProviderMetadataStep: {
headerSubtitle: LocalizationValue;
modes: {
title: LocalizationValue;
ariaLabel: LocalizationValue;
metadataUrl: LocalizationValue;
manual: LocalizationValue;
};
metadataUrl: {
label: LocalizationValue;
placeholder: LocalizationValue;
description: LocalizationValue;
};
manual: {
description: LocalizationValue;
signOnUrl: {
label: LocalizationValue;
placeholder: LocalizationValue;
};
issuer: {
label: LocalizationValue;
placeholder: LocalizationValue;
};
signingCertificate: {
label: LocalizationValue;
uploadFile: LocalizationValue;
replaceFile: LocalizationValue;
removeFile: LocalizationValue;
fileUploaded: LocalizationValue;
};
};
};
};
samlCustom: {
mainHeaderTitle: LocalizationValue;
createAppStep: {
headerSubtitle: LocalizationValue;
createAppInstructions: {
title: LocalizationValue;
paragraph: LocalizationValue;
};
serviceProviderFields: {
acsUrl: {
label: LocalizationValue;
};
spEntityId: {
label: LocalizationValue;
};
};
};
attributeMappingStep: {
headerSubtitle: LocalizationValue;
paragraph: LocalizationValue;
attributeMappingTable: {
title: LocalizationValue;
columns: {
userProfile: LocalizationValue;
attributeName: LocalizationValue;
};
rows: {
email: {
userProfile: LocalizationValue;
attributeName: LocalizationValue;
};
firstName: {
userProfile: LocalizationValue;
attributeName: LocalizationValue;
};
lastName: {
userProfile: LocalizationValue;
attributeName: LocalizationValue;
};
};
};
};
assignUsersStep: {
headerSubtitle: LocalizationValue;
title: LocalizationValue;
paragraph: LocalizationValue;
};
identityProviderMetadataStep: {
headerSubtitle: LocalizationValue;
modes: {
title: LocalizationValue;
ariaLabel: LocalizationValue;
metadataUrl: LocalizationValue;
manual: LocalizationValue;
};
metadataUrl: {
label: LocalizationValue;
placeholder: LocalizationValue;
+ description: LocalizationValue;+ };+ manual: {+ description: LocalizationValue;+ signOnUrl: {+ label: LocalizationValue;+ placeholder: LocalizationValue;+ };+ issuer: {+ label: LocalizationValue;+ placeholder: LocalizationValue;+ };+ signingCertificate: {+ label: LocalizationValue;+ uploadFile: LocalizationValue;+ replaceFile: LocalizationValue;+ removeFile: LocalizationValue;+ fileUploaded: LocalizationValue;+ };+ };+ };+ };+ samlGoogle: {+ mainHeaderTitle: LocalizationValue;+ createAppStep: {+ headerSubtitle: LocalizationValue;+ createAppInstructions: {+ title: LocalizationValue;+ step1: LocalizationValue;+ step2: LocalizationValue;+ step3: LocalizationValue;+ step4: LocalizationValue;+ step5: LocalizationValue;+ };+ };+ identityProviderMetadataStep: {+ headerSubtitle: LocalizationValue;+ modes: {+ title: LocalizationValue;+ ariaLabel: LocalizationValue;+ metadataFile: LocalizationValue;+ manual: LocalizationValue;+ };+ metadataFile: {+ label: LocalizationValue;
description: LocalizationValue;
+ uploadFile: LocalizationValue;+ replaceFile: LocalizationValue;+ removeFile: LocalizationValue;+ fileUploaded: LocalizationValue;
};
manual: {
description: LocalizationValue;
signOnUrl: {
label: LocalizationValue;
placeholder: LocalizationValue;
};
issuer: {
label: LocalizationValue;
placeholder: LocalizationValue;
};
signingCertificate: {
label: LocalizationValue;
uploadFile: LocalizationValue;
replaceFile: LocalizationValue;
removeFile: LocalizationValue;
fileUploaded: LocalizationValue;
+ };+ };+ };+ serviceProviderStep: {+ headerSubtitle: LocalizationValue;+ title: LocalizationValue;+ paragraph: LocalizationValue;+ serviceProviderFields: {+ acsUrl: {+ label: LocalizationValue;+ };+ spEntityId: {+ label: LocalizationValue;+ };+ };+ nameIdInstructions: {+ step1: LocalizationValue;+ step2: LocalizationValue;+ };+ };+ attributeMappingStep: {+ headerSubtitle: LocalizationValue;+ paragraph: LocalizationValue;+ step1: LocalizationValue;+ step2: LocalizationValue;+ attributeMappingTable: {+ columns: {+ googleAttribute: LocalizationValue;+ appAttribute: LocalizationValue;+ };+ rows: {+ email: {+ googleAttribute: LocalizationValue;+ appAttribute: LocalizationValue;+ };+ firstName: {+ googleAttribute: LocalizationValue;+ appAttribute: LocalizationValue;+ };+ lastName: {+ googleAttribute: LocalizationValue;+ appAttribute: LocalizationValue;+ };
};
+ };+ };+ configureUserAccess: {+ headerSubtitle: LocalizationValue;+ assignUsersInstructions: {+ paragraph1: LocalizationValue;+ step1: LocalizationValue;+ step2: LocalizationValue;+ step3: LocalizationValue;+ paragraph2: LocalizationValue;
};
};
};
// ... 182 unchanged lines elided ...

Static analyzer: Breaking change in type alias __internal_LocalizationResource: Type changed: {locale:string;maintenanceMode:import("@clerk/shared").LocalizationValue;roles:{[r:string]:import("@clerk/shared").Loca… → {locale:string;maintenanceMode:import("@clerk/shared").LocalizationValue;roles:{[r:string]:import("@clerk/shared").Loca…

🤖 AI review (reclassified as non-breaking) (85%): The __internal_LocalizationResource type had additions to the configureSSO.selectProviderStep.saml object (new google field) and a new configureSSO.configureStep.samlGoogle section. These are purely additive changes to a localization resource type. Since LocalizationResource is exposed as DeepPartial, consumers supplying partial localization objects are not required to provide the new fields. The type is also prefixed with __internal_ suggesting it is not meant for direct consumer use.

Modified: `FieldId`

- type FieldId = 'firstName' | 'lastName' | 'name' | 'slug' | 'emailAddress' | 'phoneNumber' | 'currentPassword' | 'newPassword' | 'signOutOfOtherSessions' | 'passkeyName' | 'password' | 'confirmPassword' | 'identifier' | 'username' | 'code' | 'role' | 'deleteConfirmation' | 'deleteOrganizationConfirmation' | 'enrollmentMode' | 'affiliationEmailAddress' | 'deleteExistingInvitationsSuggestions' | 'legalAccepted' | 'apiKeyDescription' | 'apiKeyExpirationDate' | 'apiKeyRevokeConfirmation' | 'apiKeySecret' | 'idpCertificate' | 'idpEntityId' | 'idpMetadataUrl' | 'idpSsoUrl' | 'acsUrl' | 'spEntityId' | 'web3WalletName';+ type FieldId = 'firstName' | 'lastName' | 'name' | 'slug' | 'emailAddress' | 'phoneNumber' | 'currentPassword' | 'newPassword' | 'signOutOfOtherSessions' | 'passkeyName' | 'password' | 'confirmPassword' | 'identifier' | 'username' | 'code' | 'role' | 'deleteConfirmation' | 'deleteOrganizationConfirmation' | 'enrollmentMode' | 'affiliationEmailAddress' | 'deleteExistingInvitationsSuggestions' | 'legalAccepted' | 'apiKeyDescription' | 'apiKeyExpirationDate' | 'apiKeyRevokeConfirmation' | 'apiKeySecret' | 'idpCertificate' | 'idpEntityId' | 'idpMetadata' | 'idpMetadataUrl' | 'idpSsoUrl' | 'acsUrl' | 'spEntityId' | 'web3WalletName';

Static analyzer: Breaking change in type alias FieldId: Type changed: 'firstName'|'lastName'|'name'|'slug'|'emailAddress'|'phoneNumber'|'currentPassword'|'newPassword'|'signOutOfOtherSessio… → 'firstName'|'lastName'|'name'|'slug'|'emailAddress'|'phoneNumber'|'currentPassword'|'newPassword'|'signOutOfOtherSessio…

🤖 AI review (reclassified as non-breaking) (80%): The FieldId union type gained a new member 'idpMetadata'. Adding a new member to a union type used as a field identifier is additive — existing consumer code that uses known FieldId values is unaffected, and consumers are not required to handle all union members exhaustively in well-typed code unless they have an exhaustive switch, which would be unusual for this UI-facing type.

Subpath `./url-CcPzUbGM`

🟢 Additions (1)

Added: `./url-CcPzUbGM`

New subpath export ./url-CcPzUbGM (24 exported members)

Subpath `./url-Dvy3tJz6`

🔴 Breaking Changes (1)

Changed: `./url-Dvy3tJz6`

Subpath export ./url-Dvy3tJz6 was removed

Report generated by Break Check

iagodahlem · 2026-06-01T19:09:42Z

+ <Col
+ elementDescriptor={descriptors.configureSSOInstructionsList}
+ as='ul'
+ sx={theme => ({
+ gap: theme.space.$1x5,
+ margin: 0,
+ paddingInlineStart: theme.space.$5,
+ listStyleType: 'disc',
+ })}
+ >


We have been repeating this block here, maybe we could abstract to a shared Ul component.

Will chat with Alex to see if we could create a Ul primitive on clerk/ui

agree it's turning out repetitive!

Previously, the 'Refresh logs' button was triggering a loading state on mount, since the step gets focused and the query gets triggered. We don't need to refetch on window focus, in order to rely on the refresh logs button only + the current internal polling mechanism.

LauraBeatris self-assigned this May 28, 2026

vercelBotdeployed to Preview May 28, 2026 15:01 View deployment

github-actionsBot added localizations ui labels May 28, 2026

vercelBotdeployed to Preview May 28, 2026 15:40 View deployment

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from 3fe1741 to b407275Compare May 28, 2026 15:45

vercelBotdeployed to Preview May 28, 2026 15:46 View deployment

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from b407275 to f6e8d22Compare May 28, 2026 15:47

vercelBotdeployed to Preview May 28, 2026 15:48 View deployment

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from f6e8d22 to 20ffc64Compare May 28, 2026 15:56

vercelBotdeployed to Preview May 28, 2026 15:57 View deployment

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from 20ffc64 to e22691dCompare May 28, 2026 16:10

vercelBotdeployed to Preview May 28, 2026 16:11 View deployment

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from e22691d to 1e68b4eCompare May 28, 2026 16:13

vercelBotdeployed to Preview May 28, 2026 16:14 View deployment

vercelBotdeployed to Preview May 28, 2026 16:53 View deployment

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from 0db7c4c to 10ce4d7Compare May 28, 2026 17:03

vercelBotdeployed to Preview May 28, 2026 17:03 View deployment

vercelBotdeployed to Preview May 28, 2026 17:05 View deployment

vercelBotdeployed to Preview May 28, 2026 17:09 View deployment

vercelBotdeployed to Preview May 28, 2026 17:28 View deployment

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from f5f6f55 to a1018c2Compare May 28, 2026 17:30

LauraBeatris marked this pull request as ready for review May 28, 2026 17:30

LauraBeatris requested review from a team and iagodahlem May 28, 2026 17:30

vercelBotdeployed to Preview May 28, 2026 17:31 View deployment

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from a1018c2 to 9199b6dCompare June 1, 2026 17:46

vercelBotdeployed to Preview June 1, 2026 17:46 View deployment

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from 9199b6d to e85a885Compare June 1, 2026 17:47

vercelBotdeployed to Preview June 1, 2026 17:48 View deployment

iagodahlem approved these changes Jun 1, 2026
View reviewed changes

vercelBotdeployed to Preview June 1, 2026 19:26 View deployment

LauraBeatris added 12 commits June 1, 2026 16:41

Add provider
31cf0bc

Add localization keys
ec82690

Introduce create app step
c6d4eef

Refactor identity provider form to declarative approach
e547869

Implement identity provider config for Google
61623ce

Implement service provider step for Google
ed0dd05

Implement attribute mapping for Google
980d30b

Add configure user access step for Google
d64a597

Fix stepper line height issue
0427534

Add changeset
f3c115a

Fix localizations
3ba2066

LauraBeatris force-pushed the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch from 0b0378b to 3ba2066Compare June 1, 2026 19:41

vercelBotdeployed to Preview June 1, 2026 19:42 View deployment

brkalow merged commit afb75e6 into mainJun 1, 2026
44 of 45 checks passed

brkalow deleted the laura/orgs-1533-sdk-add-support-for-google-workspace-saml branch June 1, 2026 20:08

clerk-cookie mentioned this pull request Jun 1, 2026
ci(repo): Version packages #8679
Merged

coderabbitaiBot mentioned this pull request Jun 1, 2026
feat(ui): Add Microsoft Entra SAML to self-serve SSO #8695
Merged
9 tasks

coderabbitaiBot mentioned this pull request Jun 2, 2026
feat(clerk-js,ui,shared): route <ConfigureSSO /> through org-scoped enterprise_connections #8671
Merged
14 tasks

alexcarpenter mentioned this pull request Jul 7, 2026
chore(localizations): Align all locales with en-US and make generate resilient #9100
Merged
9 tasks

Navigation Menu

Uh oh!

feat(ui): Add Google Workspace SAML to self-serve SSO - #8690

feat(ui): Add Google Workspace SAML to self-serve SSO#8690
brkalow merged 12 commits into
mainfrom
laura/orgs-1533-sdk-add-support-for-google-workspace-saml

LauraBeatris commented May 28, 2026•
edited
Loading

Uh oh!

vercelBot commented May 28, 2026•
edited
Loading

Uh oh!

changeset-botBot commented May 28, 2026•
edited
Loading

Uh oh!

pkg-pr-newBot commented May 28, 2026•
edited
Loading

Uh oh!

github-actionsBot commented May 28, 2026

Uh oh!

github-actionsBot commented Jun 1, 2026•
edited
Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

iagodahlemJun 1, 2026

Uh oh!

LauraBeatrisJun 1, 2026

Uh oh!

LauraBeatrisJun 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

LauraBeatris commented May 28, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Unrelated changes/fixes

Checklist

Type of change

Uh oh!

vercelBot commented May 28, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-botBot commented May 28, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-newBot commented May 28, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actionsBot commented May 28, 2026

API Changes Report

Summary

@clerk/shared

Subpath ./types

🟡 Non-breaking Changes (2)

Modified: __internal_LocalizationResource

Modified: FieldId

Uh oh!

github-actionsBot commented Jun 1, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

API Changes Report

Summary

@clerk/shared

Subpath ./apiUrlFromPublishableKey

🟡 Non-breaking Changes (1)

Modified: apiUrlFromPublishableKey

Subpath ./index-Dq-_K2VH

🟢 Additions (1)

Added: ./index-Dq-_K2VH

Subpath ./index-ZibUt-Ji

🔴 Breaking Changes (1)

Changed: ./index-ZibUt-Ji

Subpath ./types

🟡 Non-breaking Changes (2)

Modified: __internal_LocalizationResource

Modified: FieldId

Subpath ./url-CcPzUbGM

🟢 Additions (1)

Added: ./url-CcPzUbGM

Subpath ./url-Dvy3tJz6

🔴 Breaking Changes (1)

Changed: ./url-Dvy3tJz6

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

iagodahlemJun 1, 2026

Choose a reason for hiding this comment

Uh oh!

LauraBeatrisJun 1, 2026

Choose a reason for hiding this comment

Uh oh!

LauraBeatrisJun 1, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

LauraBeatris commented May 28, 2026•
edited
Loading

vercelBot commented May 28, 2026•
edited
Loading

changeset-botBot commented May 28, 2026•
edited
Loading

pkg-pr-newBot commented May 28, 2026•
edited
Loading

Subpath `./types`

Modified: `__internal_LocalizationResource`

Modified: `FieldId`

github-actionsBot commented Jun 1, 2026•
edited
Loading

Subpath `./apiUrlFromPublishableKey`

Modified: `apiUrlFromPublishableKey`

Subpath `./index-Dq-_K2VH`

Added: `./index-Dq-_K2VH`

Subpath `./index-ZibUt-Ji`

Changed: `./index-ZibUt-Ji`

Subpath `./types`

Modified: `__internal_LocalizationResource`

Modified: `FieldId`

Subpath `./url-CcPzUbGM`

Added: `./url-CcPzUbGM`

Subpath `./url-Dvy3tJz6`

Changed: `./url-Dvy3tJz6`