{"id":10317,"date":"2026-11-11T13:36:16","date_gmt":"2026-11-11T13:36:16","guid":{"rendered":"https:\/\/www.process.st\/help\/?post_type=ht_kb&#038;p=10317"},"modified":"2026-11-11T13:36:16","modified_gmt":"2026-11-11T13:36:16","slug":"domain-users","status":"publish","type":"ht_kb","link":"https:\/\/www.process.st\/help\/docs\/domain-users\/","title":{"rendered":"Domain Users"},"content":{"rendered":"<p>The <strong>Domain Users<\/strong> tab in your organization settings lets administrators manage users across your organization&#8217;s owned email domains. Fix SSO identity mismatches, swap email addresses to resolve duplicates, and clear stale SSO links, all without an engineering escalation.<\/p>\n<p><strong><em>Users: Only Administrators can access the Domain Users tab.<\/em><\/strong><\/p>\n<h2>What Domain Users is for<\/h2>\n<p>When your organization uses SSO (single sign-on), user accounts can sometimes get out of sync with your identity provider. Common scenarios include:<\/p>\n<ul>\n<li><strong>Mis-linked SSO identity:<\/strong> A user logs in and sees someone else&#8217;s name or account because their Process Street user is bound to the wrong identity-provider (IdP) record.<\/li>\n<li><strong>Duplicate accounts after an IdP change:<\/strong> Switching identity providers (for example, from Okta to Microsoft Entra ID) can create duplicate accounts for the same person.<\/li>\n<li><strong>Email domain migration:<\/strong> Your company moves from <code>@oldco.com<\/code> to <code>@newco.com<\/code> and user email addresses need updating across the organization.<\/li>\n<\/ul>\n<p>Previously, resolving these issues required a support ticket and manual database changes. The Domain Users tab puts these fixes directly in the hands of organization admins.<\/p>\n<h2>Open the Domain Users tab<\/h2>\n<ol>\n<li>Click your <strong>profile picture<\/strong> in the upper-right corner of your screen.<\/li>\n<li>Click <strong>Settings<\/strong>.<\/li>\n<li>Select the <strong>Domain Users<\/strong> tab.<\/li>\n<\/ol>\n<p>The tab lists every user on the email domains your organization owns. If you haven&#8217;t added a domain yet, see <a href=\"https:\/\/www.process.st\/help\/docs\/change-organization-domain\/\">Change your organization domain<\/a>.<\/p>\n<h2>Fix a user&#8217;s email or name<\/h2>\n<p>If a user&#8217;s email address or display name is incorrect (for example, after a name change or a typo during provisioning):<\/p>\n<ol>\n<li>Find the user in the <strong>Domain Users<\/strong> list.<\/li>\n<li>Update their <strong>email address<\/strong> or <strong>name<\/strong> as needed.<\/li>\n<li>Save the change.<\/li>\n<\/ol>\n<p>The updated email takes effect immediately. The user signs in with their new email on the next login.<\/p>\n<h2>Swap two users&#8217; email addresses<\/h2>\n<p>When two users have accidentally ended up with each other&#8217;s email addresses (a common side effect of duplicate accounts), swap them in one operation rather than manually reassigning each:<\/p>\n<ol>\n<li>Find both users in the <strong>Domain Users<\/strong> list.<\/li>\n<li>Use the <strong>swap<\/strong> action to exchange their email addresses.<\/li>\n<\/ol>\n<p>This resolves the duplicate without losing either user&#8217;s account history or permissions.<\/p>\n<h2>Clear a stale SSO link<\/h2>\n<p>If a user&#8217;s Process Street account is bound to the wrong identity-provider record, clearing the SSO link lets them re-bind correctly:<\/p>\n<ol>\n<li>Find the user in the <strong>Domain Users<\/strong> list.<\/li>\n<li>Clear their <strong>SSO link<\/strong>.<\/li>\n<li>Ask the user to log in again. Process Street binds them to the correct IdP account on the next SSO sign-in.<\/li>\n<\/ol>\n<blockquote>\n<p><strong>Note:<\/strong> Clearing the SSO link does not delete the user&#8217;s account or remove any of their data. It only disconnects the identity-provider binding so it can be re-established.<\/p>\n<\/blockquote>\n<h2>Common use cases<\/h2>\n<h3>User sees the wrong identity after SSO sign-in<\/h3>\n<p>A user logs in with SSO and sees another person&#8217;s name or account. This happens when their Process Street account is bound to the wrong IdP identity. Clear the stale SSO link for that user, then have them sign in again to bind to the correct identity.<\/p>\n<h3>Duplicate accounts after switching identity providers<\/h3>\n<p>When your organization migrates from one IdP to another (for example, Okta to Microsoft Entra ID), some users may end up with two Process Street accounts. Use the email swap to consolidate the accounts, then clear the SSO link on the correct account so the user re-binds to the new IdP.<\/p>\n<h3>Organization moves to a new email domain<\/h3>\n<p>Your company rebrands or merges and employees move from <code>@oldco.com<\/code> to <code>@newco.com<\/code>. Update each affected user&#8217;s email address in the Domain Users tab so their account matches the new domain. Make sure the new domain is <a href=\"https:\/\/www.process.st\/help\/docs\/change-organization-domain\/\">added to your organization<\/a> first.<\/p>\n<h2>FAQ<\/h2>\n<h3>Does clearing an SSO link delete the user&#8217;s account?<\/h3>\n<p>No. It only removes the connection between the user&#8217;s Process Street account and their identity-provider record. All their data, permissions, and group memberships remain intact. The link is re-established automatically the next time they sign in with SSO.<\/p>\n<h3>Do I need SSO enabled to use Domain Users?<\/h3>\n<p>The Domain Users tab is available to all organizations. The SSO-related actions (clearing an SSO link) apply only when your organization uses SSO.<\/p>\n<h3>What happens if I swap two users&#8217; emails?<\/h3>\n<p>Each user&#8217;s account keeps its existing data, permissions, and workflow run history. Only the email addresses are exchanged between the two accounts.<\/p>\n<h2>Related articles<\/h2>\n<ul>\n<li><a href=\"https:\/\/www.process.st\/help\/docs\/single-sign-on-sso-at-process-street\/\">Single Sign-On (SSO) at Process Street<\/a><\/li>\n<li><a href=\"https:\/\/www.process.st\/help\/docs\/change-organization-domain\/\">Change your organization domain<\/a><\/li>\n<li><a href=\"https:\/\/www.process.st\/help\/docs\/managing-members\/\">Managing users in your organization<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>The Domain Users tab in your organization settings lets administrators manage users across your organization&#8217;s owned email domains. Fix SSO identity mismatches, swap email addresses to resolve duplicates, and clear stale SSO links, all without an engineering escalation. Users: Only Administrators can access the Domain Users tab. What Domain Users is for When your organization [&hellip;]<\/p>\n","protected":false},"author":22,"template":"","meta":{"_acf_changed":false,"available_plan":"All plans","available_product":"Settings","footnotes":""},"ht_kb_category":[180],"ht_kb_tag":[],"class_list":["post-10317","ht_kb","type-ht_kb","status-publish","hentry","ht_kb_category-organization-management"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/10317","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/users\/22"}],"version-history":[{"count":1,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/10317\/revisions"}],"predecessor-version":[{"id":10404,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/10317\/revisions\/10404"}],"wp:attachment":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/media?parent=10317"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_category?post=10317"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_tag?post=10317"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}