Skip to content

Conversation

@bechols
Copy link
Contributor

@bechols bechols commented Jan 3, 2026

Summary

Adds a troubleshooting section to the Manage Users page for users who can't sign in after their email domain changed.

Problem

Users report being unable to log into Temporal Cloud after their organization changes email domains (e.g., company rebranding from @oldcompany.com to @newcompany.com). There's currently no documentation explaining why this happens or how to resolve it.

Example from community Slack:

"Hey we changed the email domain of our google account we connected to temporal. We no longer can log into temporal. How can we fix this?"

Changes

Added to docs/production-deployment/cloud/get-started/users.mdx:

  • New "How to troubleshoot account access issues" section
  • Explains why email domain changes break OAuth login
  • Provides steps to resolve via support ticket
  • Recommends SAML for organizations with frequent identity changes

Why expand existing page vs. new page

The users.mdx page already covers user account management. Adding troubleshooting here keeps related content together rather than fragmenting it across multiple pages.

Checklist

  • Follows STYLE.md guidelines (infinitive verbs in headings, sentence case)
  • Frontmatter unchanged (expanding existing page)
  • Links to related documentation (/cloud/support, /cloud/saml)
  • No sidebars.js changes needed (expanding existing page)

Users who change their email domain (e.g., company rebranding) can't log
into Temporal Cloud because OAuth identifies accounts by email address.

This adds a troubleshooting section to the users page explaining:
- Why this happens (OAuth identity tied to email)
- How to resolve (contact support with old/new email)
- Prevention tip (use SAML for enterprise identity management)

Addresses common user issue reported in community Slack.
@bechols bechols requested a review from a team as a code owner January 3, 2026 20:46
@vercel
Copy link

vercel bot commented Jan 3, 2026

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

Project Deployment Review Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Jan 3, 2026 8:47pm

@github-actions
Copy link
Contributor

github-actions bot commented Jan 3, 2026

📖 Docs PR preview links

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants