From 5ee56c2f8a4764f404ca4817075e78c2dab0a9bf Mon Sep 17 00:00:00 2001 From: Clara Jones Date: Tue, 9 Dec 2025 10:43:15 -0800 Subject: [PATCH 1/6] Update Verify-a-Domain.md Updating the documentation to reflect the last release in Release 4 of the Domains & SAML in newdot project. --- .../workspaces/Verify-a-Domain.md | 54 +++++++++++++++++-- 1 file changed, 51 insertions(+), 3 deletions(-) diff --git a/docs/articles/new-expensify/workspaces/Verify-a-Domain.md b/docs/articles/new-expensify/workspaces/Verify-a-Domain.md index 96d2d5c2b340..d69b859688a2 100644 --- a/docs/articles/new-expensify/workspaces/Verify-a-Domain.md +++ b/docs/articles/new-expensify/workspaces/Verify-a-Domain.md @@ -1,16 +1,64 @@ --- -title: Verify a Domain +title: Claim and Verify a Domain description: Learn how to claim and verify a private domain in New Expensify to enable SAML login and unlock enhanced security features. keywords: [New Expensify, claim domain, verify domain, private domain, domain settings, enhanced security, SAML, domain admin] ---
-If you have a private domain (e.g., yourcompany.com), you can verify it in Expensify to manage employee permissions and enable additional security features. +If you have a private domain (e.g., yourcompany.com), you can claim and verify it in Expensify to manage employee permissions and enable additional security features. -# Verify Your Domain +# What you can do with a claimed domain +Once you've claimed a domain, you can: +- Configure SAML login (once verified) +- Monitor domain status and ownership +Once verified, you’ll also be able to: +- Enforce SAML login for domain members + +# Step 1: Claim Your Domain + +To claim a private domain, you must: +- Be logged in with an email address from that domain +- Have verified your contact method with a magic code + +## Steps to claim your domain +1. From the left-hand menu, go to **Workspaces > Domains**. +2. Click the Enable button. +a. If you have already claimed one or more domains, click the **New** button in the upper-right hand corner > **New domain** to add a new domain. +4. Enter the name of your private domain (e.g., `yourcompany.com`) in the form. +5. Click **Continue**. + + +# Where to find domains in New Expensify + +From the left-hand menu, select **Workspaces > Domains**. + +If you haven't claimed a domain yet, you'll see a section labeled **Enhanced security** explaining the benefits of domain control. Once domains are claimed, this section is labeled **Domains**. + +Each domain is listed in its own row, showing: +- Domain name +- Verification status (Verified, Not verified) +- Overflow menu with management options + + +## What happens next? + +Depending on your email setup: + +- **If you're not using an email from that domain**: You'll see an error. You can’t claim domains you don’t belong to. +- **If your email is from that domain but not verified**: You’ll be prompted to verify your login using a magic code. +- **If the domain is already claimed**: You’ll need to coordinate with an existing admin to verify your access to the domain. + +After a successful claim, you’ll see a confirmation screen, and the domain will appear under **Workspaces > Domains** in the **Not verified** state. + + +# Step 2: Verify Your Domain + +To unlock advanced security settings and enable SAML, the domain must be verified through DNS. + +## Steps to verify your domain 1. Log in to your DNS service provider (e.g., Namecheap, GoDaddy, Amazon Route 53). If your domain is managed internally, contact your IT department. 2. Locate the DNS Records page (sometimes labeled as DNS Management or Zone File Editor). From 22c7e854245e215444f5ebf209d241c1f5b1c6a8 Mon Sep 17 00:00:00 2001 From: Clara Jones Date: Tue, 9 Dec 2025 10:44:01 -0800 Subject: [PATCH 2/6] Rename Verify-a-Domain.md to Claim-and-Verify-a-Domain.md --- .../{Verify-a-Domain.md => Claim-and-Verify-a-Domain.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/articles/new-expensify/workspaces/{Verify-a-Domain.md => Claim-and-Verify-a-Domain.md} (100%) diff --git a/docs/articles/new-expensify/workspaces/Verify-a-Domain.md b/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md similarity index 100% rename from docs/articles/new-expensify/workspaces/Verify-a-Domain.md rename to docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md From 469d9f531d19ea5b3aad760f1ac2066b89fe86ef Mon Sep 17 00:00:00 2001 From: Clara Jones Date: Tue, 9 Dec 2025 13:14:14 -0800 Subject: [PATCH 3/6] Update Claim-and-Verify-a-Domain.md --- .../workspaces/Claim-and-Verify-a-Domain.md | 21 ++++++++++--------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md b/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md index d69b859688a2..f8b4cf20ccf8 100644 --- a/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md +++ b/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md @@ -26,16 +26,16 @@ To claim a private domain, you must: ## Steps to claim your domain 1. From the left-hand menu, go to **Workspaces > Domains**. 2. Click the Enable button. -a. If you have already claimed one or more domains, click the **New** button in the upper-right hand corner > **New domain** to add a new domain. -4. Enter the name of your private domain (e.g., `yourcompany.com`) in the form. -5. Click **Continue**. + a. If you have already claimed one or more domains, click the **New** button in the upper-right hand corner > **New domain** to add a new domain. +3. Enter the name of your private domain (e.g., `yourcompany.com`) in the form. +4. Click **Continue**. -# Where to find domains in New Expensify +# Where to find domain settings From the left-hand menu, select **Workspaces > Domains**. -If you haven't claimed a domain yet, you'll see a section labeled **Enhanced security** explaining the benefits of domain control. Once domains are claimed, this section is labeled **Domains**. +If you haven't claimed a domain yet, you'll see a section labeled **Enhanced security** explaining the benefits of domain control. Once domains are claimed, the **Enhanced security** section is relabeled as **Domains**. Each domain is listed in its own row, showing: - Domain name @@ -47,20 +47,21 @@ Each domain is listed in its own row, showing: Depending on your email setup: -- **If you're not using an email from that domain**: You'll see an error. You can’t claim domains you don’t belong to. +- **If you're not using an email from that domain**: You'll see an error. You can't claim domains that don't match your email address.. - **If your email is from that domain but not verified**: You’ll be prompted to verify your login using a magic code. -- **If the domain is already claimed**: You’ll need to coordinate with an existing admin to verify your access to the domain. +- **If the domain is already claimed**: You’ll need to coordinate with an existing admin to request that your role be updated to Domain Admin. -After a successful claim, you’ll see a confirmation screen, and the domain will appear under **Workspaces > Domains** in the **Not verified** state. +After the domain is successfully claimed, the domain will appear under **Workspaces > Domains** in the **Not verified** state. # Step 2: Verify Your Domain -To unlock advanced security settings and enable SAML, the domain must be verified through DNS. +To unlock advanced security settings and enable SAML, the domain must be verified through a DNS record. ## Steps to verify your domain -1. Log in to your DNS service provider (e.g., Namecheap, GoDaddy, Amazon Route 53). If your domain is managed internally, contact your IT department. +**Note**: This process may be managed by your IT department or web consultant. +1. Log in to your DNS service provider (e.g., Namecheap, GoDaddy, Amazon Route 53). 2. Locate the DNS Records page (sometimes labeled as DNS Management or Zone File Editor). 3. Add a TXT record with the verification value provided in Expensify under **Workspaces > Domains > three-dot menu > Verify domain**. 4. Save your changes. From 395eebc3e097af4efdd7da8d3851e151d5c9908e Mon Sep 17 00:00:00 2001 From: Clara Jones Date: Fri, 12 Dec 2025 11:46:23 -0800 Subject: [PATCH 4/6] Update redirects.csv --- docs/redirects.csv | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/redirects.csv b/docs/redirects.csv index 30cc144314da..dea29cd1a8f7 100644 --- a/docs/redirects.csv +++ b/docs/redirects.csv @@ -892,3 +892,4 @@ https://help.expensify.com/classic,https://help.expensify.com/expensify-classic/ https://help.expensify.com/articles/new-expensify/expensify-card/Enable-Expensify-Card-notifications,https://help.expensify.com/articles/new-expensify/expensify-card/Expensify-Card-Notifications https://help.expensify.com/articles/expensify-classic/bank-accounts-and-payments/bank-accounts.md/Add-or-remove-a-business-bank-account,https://help.expensify.com/articles/expensify-classic/bank-accounts-and-payments/bank-accounts/Connect-US-Business-Bank-Account https://help.expensify.com/articles/Unlisted/Compliance-Documentation.md,https://help.expensify.com/articles/new-expensify/settings/Encryption-and-Data-Security +https://help.expensify.com/articles/new-expensify/workspaces/Verify-a-Domain,https://help.expensify.com/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain From b60e8442cbedb7b837010d4762df595c042952c6 Mon Sep 17 00:00:00 2001 From: Clara Jones Date: Mon, 15 Dec 2025 09:58:34 -0800 Subject: [PATCH 5/6] Update Claim-and-Verify-a-Domain.md --- .../workspaces/Claim-and-Verify-a-Domain.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md b/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md index f8b4cf20ccf8..7dfc83dc0de4 100644 --- a/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md +++ b/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md @@ -8,14 +8,17 @@ keywords: [New Expensify, claim domain, verify domain, private domain, domain se If you have a private domain (e.g., yourcompany.com), you can claim and verify it in Expensify to manage employee permissions and enable additional security features. -# What you can do with a claimed domain +# What you can do with a claimed and verified domain Once you've claimed a domain, you can: -- Configure SAML login (once verified) -- Monitor domain status and ownership +- Grant specific permissions to employees using the domain in their email address. +- Import and reconcile company credit cards and Expensify Cards. +- Apply company credit card and Expensify Card rules. Once verified, you’ll also be able to: -- Enforce SAML login for domain members +- Assign delegates for employees on vacation. +- Delete employee Expensify accounts. +- Enable SAML/SSO for secure login. # Step 1: Claim Your Domain From 2b79825404289d7f318d6a8c59220ef56909d400 Mon Sep 17 00:00:00 2001 From: Clara Jones Date: Mon, 15 Dec 2025 11:33:19 -0800 Subject: [PATCH 6/6] Update Claim-and-Verify-a-Domain.md --- .../workspaces/Claim-and-Verify-a-Domain.md | 12 +++--------- 1 file changed, 3 insertions(+), 9 deletions(-) diff --git a/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md b/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md index 7dfc83dc0de4..3231f0ac877c 100644 --- a/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md +++ b/docs/articles/new-expensify/workspaces/Claim-and-Verify-a-Domain.md @@ -10,15 +10,9 @@ If you have a private domain (e.g., yourcompany.com), you can claim and verify i # What you can do with a claimed and verified domain -Once you've claimed a domain, you can: -- Grant specific permissions to employees using the domain in their email address. -- Import and reconcile company credit cards and Expensify Cards. -- Apply company credit card and Expensify Card rules. - -Once verified, you’ll also be able to: -- Assign delegates for employees on vacation. -- Delete employee Expensify accounts. -- Enable SAML/SSO for secure login. +Once you've claimed and verified a domain, you can: +- Configure SAML login +- Enforce SAML login for domain members # Step 1: Claim Your Domain