From fde287cc3d051440cf0c60d5bd1bf14f954a24b0 Mon Sep 17 00:00:00 2001 From: Michael Novotny Date: Mon, 27 Jul 2026 10:31:20 -0500 Subject: [PATCH 1/2] docs(backend): Correct the Dashboard toggle name for blockDisposableEmailDomains The bolded label read "Block sign-ups that use disposable email domains", but the toggle in the Clerk Dashboard is "Block sign-ups that use disposable email addresses". Property names are unchanged. Co-Authored-By: Claude Opus 5 --- .changeset/fix-disposable-email-toggle-label.md | 5 +++++ packages/backend/src/api/endpoints/InstanceApi.ts | 2 +- packages/backend/src/api/resources/InstanceRestrictions.ts | 2 +- 3 files changed, 7 insertions(+), 2 deletions(-) create mode 100644 .changeset/fix-disposable-email-toggle-label.md diff --git a/.changeset/fix-disposable-email-toggle-label.md b/.changeset/fix-disposable-email-toggle-label.md new file mode 100644 index 00000000000..de80114c9e6 --- /dev/null +++ b/.changeset/fix-disposable-email-toggle-label.md @@ -0,0 +1,5 @@ +--- +'@clerk/backend': patch +--- + +Correct the Dashboard toggle name referenced in the `blockDisposableEmailDomains` documentation. The bolded label read "Block sign-ups that use disposable email domains", but the toggle in the Clerk Dashboard is "Block sign-ups that use disposable email addresses". The property name is unchanged. diff --git a/packages/backend/src/api/endpoints/InstanceApi.ts b/packages/backend/src/api/endpoints/InstanceApi.ts index c304ddf0c5c..884dbd84528 100644 --- a/packages/backend/src/api/endpoints/InstanceApi.ts +++ b/packages/backend/src/api/endpoints/InstanceApi.ts @@ -36,7 +36,7 @@ export type UpdateRestrictionsParams = { blocklist?: boolean | null | undefined; /** Whether the instance should have [**Block email subaddresses**](https://clerk.com/docs/guides/secure/restricting-access#block-email-subaddresses) enabled. */ blockEmailSubaddresses?: boolean | null | undefined; - /** Whether the instance should have [**Block sign-ups that use disposable email domains**](https://clerk.com/docs/guides/secure/restricting-access#block-sign-ups-that-use-disposable-email-addresses) enabled. */ + /** Whether the instance should have [**Block sign-ups that use disposable email addresses**](https://clerk.com/docs/guides/secure/restricting-access#block-sign-ups-that-use-disposable-email-addresses) enabled. */ blockDisposableEmailDomains?: boolean | null | undefined; /** Whether the instance should [ignore dots for Gmail addresses](https://clerk.com/docs/guides/secure/restricting-access#block-email-subaddresses). */ ignoreDotsForGmailAddresses?: boolean | null | undefined; diff --git a/packages/backend/src/api/resources/InstanceRestrictions.ts b/packages/backend/src/api/resources/InstanceRestrictions.ts index 679f50539ec..a3ce9279995 100644 --- a/packages/backend/src/api/resources/InstanceRestrictions.ts +++ b/packages/backend/src/api/resources/InstanceRestrictions.ts @@ -9,7 +9,7 @@ export class InstanceRestrictions { readonly blocklist: boolean, /** Whether the instance has [**Block email subaddresses**](https://clerk.com/docs/guides/secure/restricting-access#block-email-subaddresses) enabled. */ readonly blockEmailSubaddresses: boolean, - /** Whether the instance has [**Block sign-ups that use disposable email domains**](https://clerk.com/docs/guides/secure/restricting-access#block-sign-ups-that-use-disposable-email-addresses) enabled. */ + /** Whether the instance has [**Block sign-ups that use disposable email addresses**](https://clerk.com/docs/guides/secure/restricting-access#block-sign-ups-that-use-disposable-email-addresses) enabled. */ readonly blockDisposableEmailDomains: boolean, /** Whether the instance has [**Ignore dots for Gmail addresses**](https://clerk.com/docs/guides/secure/restricting-access#block-email-subaddresses) enabled. */ readonly ignoreDotsForGmailAddresses: boolean, From 1bf6b4a0c43a595c2a62806d656facb69936e141 Mon Sep 17 00:00:00 2001 From: Michael Novotny Date: Mon, 27 Jul 2026 10:55:21 -0500 Subject: [PATCH 2/2] docs(backend): Unbold the Gmail dots label in InstanceRestrictions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit No "Ignore dots for Gmail addresses" toggle exists in the Clerk Dashboard — the setting appears only in the generated DAPI spec, and the backend strips Gmail dots unconditionally. Bold marks a Dashboard label, so this drops it and matches the wording already used on UpdateRestrictionsParams. Co-Authored-By: Claude Opus 5 --- .changeset/fix-disposable-email-toggle-label.md | 2 +- packages/backend/src/api/resources/InstanceRestrictions.ts | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.changeset/fix-disposable-email-toggle-label.md b/.changeset/fix-disposable-email-toggle-label.md index de80114c9e6..b3d95a583ed 100644 --- a/.changeset/fix-disposable-email-toggle-label.md +++ b/.changeset/fix-disposable-email-toggle-label.md @@ -2,4 +2,4 @@ '@clerk/backend': patch --- -Correct the Dashboard toggle name referenced in the `blockDisposableEmailDomains` documentation. The bolded label read "Block sign-ups that use disposable email domains", but the toggle in the Clerk Dashboard is "Block sign-ups that use disposable email addresses". The property name is unchanged. +Correct two Dashboard labels referenced in the instance restrictions documentation. `blockDisposableEmailDomains` bolded "Block sign-ups that use disposable email domains", but the toggle in the Clerk Dashboard is "Block sign-ups that use disposable email addresses". `ignoreDotsForGmailAddresses` bolded "Ignore dots for Gmail addresses" as a Dashboard toggle, but no such control exists — the wording now matches the equivalent comment on `UpdateRestrictionsParams`. Property names are unchanged. diff --git a/packages/backend/src/api/resources/InstanceRestrictions.ts b/packages/backend/src/api/resources/InstanceRestrictions.ts index a3ce9279995..3a4ebcc2c90 100644 --- a/packages/backend/src/api/resources/InstanceRestrictions.ts +++ b/packages/backend/src/api/resources/InstanceRestrictions.ts @@ -11,7 +11,7 @@ export class InstanceRestrictions { readonly blockEmailSubaddresses: boolean, /** Whether the instance has [**Block sign-ups that use disposable email addresses**](https://clerk.com/docs/guides/secure/restricting-access#block-sign-ups-that-use-disposable-email-addresses) enabled. */ readonly blockDisposableEmailDomains: boolean, - /** Whether the instance has [**Ignore dots for Gmail addresses**](https://clerk.com/docs/guides/secure/restricting-access#block-email-subaddresses) enabled. */ + /** Whether the instance is set to [ignore dots for Gmail addresses](https://clerk.com/docs/guides/secure/restricting-access#block-email-subaddresses). */ readonly ignoreDotsForGmailAddresses: boolean, ) {}