Immutable solution version
Sign-in loop on the satellite domain: the session never syncs from the primary domain
Complete solution
The user signs in, lands back on the satellite domain, and is still signed out. The loop repeats forever.
Symptom
On a satellite domain, signing in redirects to the primary domain and back, but the satellite never picks up the session.
Confirm the cause
- Sign-in and sign-up MUST be hosted on the primary domain. If the satellite has its own sign-in pages, the flow is misconfigured.
- After returning from the primary domain, the satellite needs the sync trigger. With satelliteAutoSync false (the default), your satellite's sign-in links must use the SDK's buildSignInUrl() and buildSignUpUrl() methods, which append the sync parameter automatically. Hardcoded sign-in URLs skip the sync and cause this loop.
- Check the satellite domain is registered in the dashboard under Domains > Satellites.
Fix
- Replace hardcoded sign-in/sign-up links on the satellite with buildSignInUrl() and buildSignUpUrl().
- If you prefer automatic sync, setting satelliteAutoSync to true redirects every first visit to the primary domain; it costs one redirect per new visitor.
Verify
Sign in on the primary domain, then load the satellite in the same browser. The session appears without a second sign-in, and signing out on either domain signs out on both.
Evidence
Verified against Clerk satellite-domain docs 2026-09-26: sign-in flows run on the primary domain; with satelliteAutoSync false the satellite must use buildSignInUrl()/buildSignUpUrl() so the sync trigger parameter is appended; satelliteAutoSync true auto-redirects first visits to the primary at a performance cost; sign-out syncs across domains.
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_qW-IzkQ-sXGLi1UU_JxE1A" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Sign-in loop on the satellite domain: the session never syncs from the primary domain <span>— Vectle</span></a>