fix(react): Respect ui prop when Clerk instance is passed to IsomorphicClerk by royanger · Pull Request #7997 · clerk/javascript

royanger · 2026-03-05T18:36:57Z

Description

The guard that causes the bug is:

const shouldLoadUi = !this.options.Clerk && this.options.standardBrowser !== false;

@clerk/react, @clerk/nextjs, etc.: this.options.Clerk is undefined → !this.options.Clerk is true → shouldLoadUi is true → getClerkUIEntryChunk() runs → finds uiProp.ClerkUI from the ui prop and returns it → ClerkUI is valid, no overwrite.

@clerk/chrome-extension: this.options.Clerk is a Clerk instance (truthy) → !this.options.Clerk is false → shouldLoadUi is false → ClerkUI = undefined → overwrites the valid ClerkUI from the ui prop.

The chrome-extension needs its own Clerk instance because it has to wire up extension-specific hooks (JWT handling, cookie syncing, storage cache, etc.) in createClerkClient before the instance is used.

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

changeset-bot · 2026-03-05T18:37:02Z

🦋 Changeset detected

Latest commit: 55641a5

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

This PR includes changesets to release 6 packages

Name	Type
@clerk/react	Minor
@clerk/chrome-extension	Patch
@clerk/expo	Patch
@clerk/nextjs	Patch
@clerk/react-router	Patch
@clerk/tanstack-react-start	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

vercel · 2026-03-05T18:37:02Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Mar 6, 2026 10:41pm

royanger · 2026-03-05T18:59:39Z

!snapshot

royanger · 2026-03-05T19:09:46Z

!snapshot

tmilewski · 2026-03-05T19:18:48Z

!snapshot

royanger · 2026-03-05T19:33:45Z

!snapshot

brkalow · 2026-03-05T20:01:42Z

packages/react/src/isomorphicClerk.ts

@@ -474,7 +474,7 @@ export class IsomorphicClerk implements IsomorphicLoadedClerk {
        this.beforeLoad(clerk);
        // Only load UI scripts in standard browser environments (not native/headless)
        const shouldLoadUi = !this.options.Clerk && this.options.standardBrowser !== false;


Do you think shouldLoadUi should be false if this.options.ui?.ClerkUI exists? or is that already handled elsewhere?

Nope. I was mostly starting with a draft PR so I could get snapshots, since this issue wasn't showing up in local testing. The updated change in 2dc46ff should be a better approach, but I still need to test it.

.changeset/tricky-apples-attend.md

royanger · 2026-03-06T20:39:25Z

!snapshot

royanger · 2026-03-06T20:57:13Z

!snapshot

clerk-cookie · 2026-03-06T20:59:37Z

Hey @royanger - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.3.2-snapshot.v20260306205749
@clerk/astro	3.0.2-snapshot.v20260306205749
@clerk/backend	3.0.2-snapshot.v20260306205749
@clerk/chrome-extension	3.1.0-snapshot.v20260306205749
@clerk/clerk-js	6.0.1-snapshot.v20260306205749
@clerk/dev-cli	0.1.1-snapshot.v20260306205749
@clerk/expo	3.0.2-snapshot.v20260306205749
@clerk/expo-passkeys	1.0.2-snapshot.v20260306205749
@clerk/express	2.0.2-snapshot.v20260306205749
@clerk/fastify	3.0.2-snapshot.v20260306205749
@clerk/hono	0.0.4-snapshot.v20260306205749
@clerk/localizations	4.0.1-snapshot.v20260306205749
@clerk/msw	0.0.2-snapshot.v20260306205749
@clerk/nextjs	7.0.2-snapshot.v20260306205749
@clerk/nuxt	2.0.2-snapshot.v20260306205749
@clerk/react	6.1.0-snapshot.v20260306205749
@clerk/react-router	3.0.2-snapshot.v20260306205749
@clerk/shared	4.0.1-snapshot.v20260306205749
@clerk/tanstack-react-start	1.0.2-snapshot.v20260306205749
@clerk/testing	2.0.2-snapshot.v20260306205749
@clerk/ui	1.1.0-snapshot.v20260306205749
@clerk/upgrade	2.0.2-snapshot.v20260306205749
@clerk/vue	2.0.2-snapshot.v20260306205749

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.3.2-snapshot.v20260306205749 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.2-snapshot.v20260306205749 --save-exact

@clerk/backend

npm i @clerk/backend@3.0.2-snapshot.v20260306205749 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.1.0-snapshot.v20260306205749 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.0.1-snapshot.v20260306205749 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@0.1.1-snapshot.v20260306205749 --save-exact

@clerk/expo

npm i @clerk/expo@3.0.2-snapshot.v20260306205749 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.2-snapshot.v20260306205749 --save-exact

@clerk/express

npm i @clerk/express@2.0.2-snapshot.v20260306205749 --save-exact

@clerk/fastify

npm i @clerk/fastify@3.0.2-snapshot.v20260306205749 --save-exact

@clerk/hono

npm i @clerk/hono@0.0.4-snapshot.v20260306205749 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.0.1-snapshot.v20260306205749 --save-exact

@clerk/msw

npm i @clerk/msw@0.0.2-snapshot.v20260306205749 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.2-snapshot.v20260306205749 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.0.2-snapshot.v20260306205749 --save-exact

@clerk/react

npm i @clerk/react@6.1.0-snapshot.v20260306205749 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.2-snapshot.v20260306205749 --save-exact

@clerk/shared

npm i @clerk/shared@4.0.1-snapshot.v20260306205749 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.2-snapshot.v20260306205749 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.2-snapshot.v20260306205749 --save-exact

@clerk/ui

npm i @clerk/ui@1.1.0-snapshot.v20260306205749 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.2-snapshot.v20260306205749 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.2-snapshot.v20260306205749 --save-exact

…ome-extensions

royanger · 2026-03-06T22:42:17Z

!snapshot

clerk-cookie · 2026-03-06T22:44:54Z

Hey @royanger - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.3.2-snapshot.v20260306224304
@clerk/astro	3.0.2-snapshot.v20260306224304
@clerk/backend	3.0.2-snapshot.v20260306224304
@clerk/chrome-extension	3.1.0-snapshot.v20260306224304
@clerk/clerk-js	6.1.0-snapshot.v20260306224304
@clerk/dev-cli	0.1.1-snapshot.v20260306224304
@clerk/expo	3.1.0-snapshot.v20260306224304
@clerk/expo-passkeys	1.0.2-snapshot.v20260306224304
@clerk/express	2.0.2-snapshot.v20260306224304
@clerk/fastify	3.0.2-snapshot.v20260306224304
@clerk/hono	0.0.4-snapshot.v20260306224304
@clerk/localizations	4.1.0-snapshot.v20260306224304
@clerk/msw	0.0.2-snapshot.v20260306224304
@clerk/nextjs	7.0.2-snapshot.v20260306224304
@clerk/nuxt	2.0.2-snapshot.v20260306224304
@clerk/react	6.1.0-snapshot.v20260306224304
@clerk/react-router	3.0.2-snapshot.v20260306224304
@clerk/shared	4.1.0-snapshot.v20260306224304
@clerk/tanstack-react-start	1.0.2-snapshot.v20260306224304
@clerk/testing	2.0.2-snapshot.v20260306224304
@clerk/ui	1.1.0-snapshot.v20260306224304
@clerk/upgrade	2.0.2-snapshot.v20260306224304
@clerk/vue	2.0.2-snapshot.v20260306224304

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.3.2-snapshot.v20260306224304 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.2-snapshot.v20260306224304 --save-exact

@clerk/backend

npm i @clerk/backend@3.0.2-snapshot.v20260306224304 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.1.0-snapshot.v20260306224304 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.1.0-snapshot.v20260306224304 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@0.1.1-snapshot.v20260306224304 --save-exact

@clerk/expo

npm i @clerk/expo@3.1.0-snapshot.v20260306224304 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.2-snapshot.v20260306224304 --save-exact

@clerk/express

npm i @clerk/express@2.0.2-snapshot.v20260306224304 --save-exact

@clerk/fastify

npm i @clerk/fastify@3.0.2-snapshot.v20260306224304 --save-exact

@clerk/hono

npm i @clerk/hono@0.0.4-snapshot.v20260306224304 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.1.0-snapshot.v20260306224304 --save-exact

@clerk/msw

npm i @clerk/msw@0.0.2-snapshot.v20260306224304 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.2-snapshot.v20260306224304 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.0.2-snapshot.v20260306224304 --save-exact

@clerk/react

npm i @clerk/react@6.1.0-snapshot.v20260306224304 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.2-snapshot.v20260306224304 --save-exact

@clerk/shared

npm i @clerk/shared@4.1.0-snapshot.v20260306224304 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.2-snapshot.v20260306224304 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.2-snapshot.v20260306224304 --save-exact

@clerk/ui

npm i @clerk/ui@1.1.0-snapshot.v20260306224304 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.2-snapshot.v20260306224304 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.2-snapshot.v20260306224304 --save-exact

fix: Respect ui prop when Clerk instance is passed to ClerkProvider

a2d370f

github-actions bot added the react label Mar 5, 2026

chore: Add changeset

42cc094

royanger changed the title ~~fix: Respect ui prop when Clerk instance is passed to ClerkProvider~~ fix(react): Respect ui prop when Clerk instance is passed to IsomorphicClerk Mar 5, 2026

vercel bot deployed to Preview March 5, 2026 18:58 View deployment

brkalow reviewed Mar 5, 2026

View reviewed changes

.changeset/tricky-apples-attend.md Outdated Show resolved Hide resolved

fix: Fixed changeset formatting

3f4e299

vercel bot deployed to Preview March 6, 2026 20:56 View deployment

fix: Updated fix

2dc46ff

vercel bot deployed to Preview March 6, 2026 22:36 View deployment

Merge branch 'main' into roy/fix-clerk-loaded-without-ui-error-in-chr…

55641a5

…ome-extensions

vercel bot deployed to Preview March 6, 2026 22:41 View deployment

Conversation

royanger commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Uh oh!

changeset-bot bot commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

royanger commented Mar 5, 2026

Uh oh!

royanger commented Mar 5, 2026

Uh oh!

tmilewski commented Mar 5, 2026

Uh oh!

royanger commented Mar 5, 2026

Uh oh!

brkalow Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

royanger Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

royanger commented Mar 6, 2026

Uh oh!

royanger commented Mar 6, 2026

Uh oh!

clerk-cookie commented Mar 6, 2026

Uh oh!

royanger commented Mar 6, 2026

Uh oh!

clerk-cookie commented Mar 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

royanger commented Mar 5, 2026 •

edited

Loading

changeset-bot bot commented Mar 5, 2026 •

edited

Loading

vercel bot commented Mar 5, 2026 •

edited

Loading