Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude/skills/playwright-app-testing/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Do NOT add arbitrary waits after actions. Instead, take a snapshot to check the
When signing in to dev environment:
- **Email**: Generate random Gmail address (e.g., `user+throwaway<random>@gmail.com`)
- **New Account**: Press join to create account
- **Existing Account**: Magic code: Always `000000`
- **Existing Account**: Security code: Always `000000`
- **Onboarding**: The `SKIP_ONBOARDING` env flag is set to `false` by default in `.env`. When `false`, onboarding screens will appear after sign-in for new accounts. Unless you are specifically asked to test onboarding, update the flag to `true` before starting the dev server so that onboarding is bypassed entirely:
```bash
sed -i '' 's/SKIP_ONBOARDING=false/SKIP_ONBOARDING=true/' .env
Expand Down
2 changes: 1 addition & 1 deletion contributingGuides/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -244,7 +244,7 @@ During communication with Expensify, you will come across a variety of acronyms
- **VBA:** Verified Bank Account (Bank account that has been verified as real and belonging to the correct business/individual)
- **NAB:** Not a Blocker (An issue that doesn't block progress, but would be nice to not have)
- **IOU:** I owe you (used to describe payment requests between users)
- **OTP:** One-time password, or magic sign-in
- **OTP:** One-time password, or security sign-in
- **RHP:** Right Hand Panel (on larger screens, pages are often displayed docked to the right side of the screen)
- **QA:** Quality Assurance
- **GH:** GitHub
Expand Down
4 changes: 0 additions & 4 deletions docs/Hidden/issues-receiving-the-magic-code.md

This file was deleted.

4 changes: 4 additions & 0 deletions docs/Hidden/issues-receiving-the-security-code.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: Issues Receiving the Security Code
description: Troubleshoot problems with receiving the security code and access your Expensify account without interruptions.
---
4 changes: 2 additions & 2 deletions docs/articles/Unlisted/Upcoming-Login-And-Security.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Upcoming Features – Login & Security (New Expensify)
description: Internal AgentZero reference for planned and in-development login and security features in New Expensify. Not for public search indexing.
keywords: upcoming, coming soon, planned, roadmap, passwordless login, Magic Code, sign in, authentication, account security, AgentZero reference
keywords: upcoming, coming soon, planned, roadmap, passwordless login, Security Code, sign in, authentication, account security, AgentZero reference
noindex: true
sitemap: false
internalScope: For AgentZero and internal tooling only. Use this page to give accurate, forward-looking answers about login and security features that are planned but not yet generally available. Do not expose this URL in user-facing help.
Expand All @@ -11,4 +11,4 @@ internalScope: For AgentZero and internal tooling only. Use this page to give ac

This page is an **AgentZero reference** for login and security features that are planned or in development for New Expensify. Use it to answer "is this coming soon?" questions accurately. These items are subject to change.

- **Simplified passwordless login** – Improve the Magic Code login experience to reduce friction for users who struggle with the current flow, while maintaining strong account security.
- **Simplified passwordless login** – Improve the Security Code login experience to reduce friction for users who struggle with the current flow, while maintaining strong account security.
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,7 @@ Enable Two-Factor Authentication (2FA) to protect your account.
- Scan the QR code.
- Enter the 6-digit code into Expensify and click **Verify**.

At future logins, Expensify will send a **magic code** to your email. You must also enter a new 6-digit code from your authenticator app.
At future logins, Expensify will send a **security code** to your email. You must also enter a new 6-digit code from your authenticator app.

Check out this resource for additional instructions on [setting up 2FA](/articles/expensify-classic/settings/Two-Factor-Authentication).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ Monitor spending trends, forecast budgets, and build reports with [the Insights
2. Toggle on 2FA and save your recovery codes. **Note on Backup Codes:** Download or copy them to a secure location.
3. Link your authenticator app by scanning the QR code or entering a code.

When logging in, use the Magic Code from your email and the 6-digit code from your authenticator app.
When logging in, use the Security Code from your email and the 6-digit code from your authenticator app.

---

Expand Down
40 changes: 20 additions & 20 deletions docs/articles/expensify-classic/settings/Avoiding-common-scams.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,31 @@
---
title: Avoiding common scams
description: Learn how to recognize and avoid common phishing scams that pretend to be from Expensify, including fake phone calls and emails asking for your Magic Code.
keywords: [Expensify scam, phishing, Magic Code, security, login code, avoid fraud, suspicious email, fake call, fraud prevention]
internalScope: Audience is all Expensify members. Covers identifying and responding to scams involving Magic Codes. Does not cover account recovery or dispute workflows.
description: Learn how to recognize and avoid common phishing scams that pretend to be from Expensify, including fake phone calls and emails asking for your Security Code.
keywords: [Expensify scam, phishing, Security Code, security, login code, avoid fraud, suspicious email, fake call, fraud prevention]
internalScope: Audience is all Expensify members. Covers identifying and responding to scams involving Security Codes. Does not cover account recovery or dispute workflows.
---

# Avoiding common scams

Some scammers try to impersonate Expensify by sending fake emails or calling you directly, often asking for your **Magic Code** (your login code). These scams are designed to trick you into giving up access to your Expensify account.
Some scammers try to impersonate Expensify by sending fake emails or calling you directly, often asking for your **Security Code** (your login code). These scams are designed to trick you into giving up access to your Expensify account.

This article explains how these scams work, how to recognize them, and what actions to take.

**Note:** Expensify will never call you asking for login codes, passwords, or payment information. If you receive such a call, it's a scam.

---

## What is the Magic Code?
## What is the Security Code?

The **Magic Code** is a one-time login code Expensify emails or texts to you when you sign in without a password. It should only be used by **you** during login.
The **Security Code** is a one-time login code Expensify emails or texts to you when you sign in without a password. It should only be used by **you** during login.

**Expensify will never call, email, or message you to ask for your Magic Code.**
**Expensify will never call, email, or message you to ask for your Security Code.**

---

## How to recognize phone call scams pretending to be Expensify

- The scammer claims to be from Expensify and needs your Magic Code to verify your account.
- The scammer claims to be from Expensify and needs your Security Code to verify your account.
- They may spoof a legitimate phone number to make it seem more convincing.
- Some scammers may create a sense of urgency (e.g., “We detected suspicious activity on your account.”)

Expand All @@ -36,16 +36,16 @@ The **Magic Code** is a one-time login code Expensify emails or texts to you whe
## How to recognize phishing emails or texts pretending to be Expensify

- Emails and text messages often look like they’re from Expensify or Visa, but the sender address is likely not from an expensify.com email address.
- These emails and text messages may have links that lead to a fake login page, prompt you to reset your password, or ask you to reply with your Magic Code.
- These emails and text messages may have links that lead to a fake login page, prompt you to reset your password, or ask you to reply with your Security Code.
- Scammers sometimes use urgent language like “Your account will be closed if you don’t respond.”

**Don’t click suspicious links, and never share your Magic Code in email. Expensify will only generate a magic code for you when you take an action in the app, such as logging in or making a high-risk change.**
**Don’t click suspicious links, and never share your Security Code in email. Expensify will only generate a security code for you when you take an action in the app, such as logging in or making a high-risk change.**

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Terminology casing inconsistency: This line uses lowercase "security code" ("Expensify will only generate a security code for you...") while the rest of the diff capitalizes it as Security Code. Per HELPSITE_NAMING_CONVENTIONS.md, match capitalization exactly and be consistent. Use Security Code.


---

## How to protect your Expensify account

- **Never share your Magic Code** — not over the phone, not by email, not via text.
- **Never share your Security Code** — not over the phone, not by email, not via text.
- **Don’t click suspicious links** — always verify the sender’s email address.
- **Use two-factor authentication (2FA)** - this adds an extra layer of security to your account.
- **If in doubt, message Concierge** - reach out directly from within the Expensify app.
Expand All @@ -54,23 +54,23 @@ The **Magic Code** is a one-time login code Expensify emails or texts to you whe

---

## What to do if you receive a Magic Code you didn't request
## What to do if you receive a Security Code you didn't request

If you receive a Magic Code email but didn’t try to log in, this does not necessarily mean your account has been compromised. It can happen for a variety of reasons, such as someone mistyping an email address.
If you receive a Security Code email but didn’t try to log in, this does not necessarily mean your account has been compromised. It can happen for a variety of reasons, such as someone mistyping an email address.

Here's what to do:

1. **Do not share the code with anyone** — simply ignore or delete the email.
2. **Do not click any links** in the email.
3. **Consider enabling [two-factor authentication](/articles/expensify-classic/settings/Two-Factor-Authentication)** for extra account security.

**Note:** You do not need to lock your account just because you received an unexpected Magic Code. Only lock your account if you believe someone has gained access to your email account or if you shared your Magic Code with someone.
**Note:** You do not need to lock your account just because you received an unexpected Security Code. Only lock your account if you believe someone has gained access to your email account or if you shared your Security Code with someone.

---

## What to do if you shared your Magic Code
## What to do if you shared your Security Code

If you accidentally gave someone your Magic Code, act fast:
If you accidentally gave someone your Security Code, act fast:

1. **[Lock your Expensify account](/articles/expensify-classic/settings/Report-Suspicious-Activity)** immediately to block unauthorized access.
2. **Contact Concierge** from a safe device and explain the situation.
Expand All @@ -94,17 +94,17 @@ If you believe your account has been targeted or compromised:

# FAQ

## Why does Expensify use Magic Codes for login?
## Why does Expensify use Security Codes for login?

Expensify uses Magic Codes instead of passwords to simplify login while keeping your account secure. These codes are valid for one-time use and expire quickly.
Expensify uses Security Codes instead of passwords to simplify login while keeping your account secure. These codes are valid for one-time use and expire quickly.

## How do I know if an email is really from Expensify?

Legitimate Expensify emails always come from an address ending in **@expensify.com** or **@team.expensify.com**. If you’re unsure, don’t click any links — just log into the Expensify app directly and message Concierge.

## I received a Magic Code I didn't request. Is my account compromised?
## I received a Security Code I didn't request. Is my account compromised?

No. Receiving an unrequested Magic Code does not mean your account is compromised. It most likely means someone entered your email address by mistake when trying to log in. As long as you don't share the code with anyone, your account is safe. You can simply ignore or delete the email. If you want extra protection, enable [two-factor authentication](/articles/expensify-classic/settings/Two-Factor-Authentication).
No. Receiving an unrequested Security Code does not mean your account is compromised. It most likely means someone entered your email address by mistake when trying to log in. As long as you don't share the code with anyone, your account is safe. You can simply ignore or delete the email. If you want extra protection, enable [two-factor authentication](/articles/expensify-classic/settings/Two-Factor-Authentication).

## Can Expensify call me?

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Your **primary contact method** on Expensify is used for receiving all notificat
2. Under **Profile**, find **Contact Methods**, and click **Add Contact Method**.
3. Enter the Email address or phone number you want to use.
- For phone numbers, include the international code if applicable.
4. Check your Email or text messages for a verification Magic Code and enter it in the required field.
4. Check your Email or text messages for a verification Security Code and enter it in the required field.

---

Expand Down
22 changes: 11 additions & 11 deletions docs/articles/expensify-classic/settings/Email-Notifications.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
---
title: Expensify Email Notifications
description: Troubleshooting steps for receiving emails and notifications from Expensify, including Magic Code login emails and unblock procedures.
keywords: [Expensify Classic, Email notifications, spam settings, magic code not received, login email missing, cannot sign in, expensify email blocked, expensify login help, email deliverability, spam filter, unblock email]
description: Troubleshooting steps for receiving emails and notifications from Expensify, including Security Code login emails and unblock procedures.
keywords: [Expensify Classic, Email notifications, spam settings, security code not received, login email missing, cannot sign in, expensify email blocked, expensify login help, email deliverability, spam filter, unblock email]
---
Occasionally, members may have trouble receiving Email notifications from Expensify, including Magic Code Emails, account validation Emails, contact method validations, integration Emails, or report action notifications.
Occasionally, members may have trouble receiving Email notifications from Expensify, including Security Code Emails, account validation Emails, contact method validations, integration Emails, or report action notifications.

---

# Magic Code Login Emails
# Security Code Login Emails

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Heading structure violation: This is a second # (H1) heading in the article. Per HELP_AUTHORING_GUIDELINES.md Section 4, an article may have exactly one # heading (the title) plus an optional # FAQ — no other # headings. Demote this to ## Security Code login emails (and make it task-based, e.g. ## How Security Code login emails work).


Magic Code emails are sent when you log in to Expensify and are critical for account access. These emails may be delayed or blocked due to spam filtering, corporate email policies, or server-level blocks. If you choose to or are automatically directed to sign in via SAML/SSO, you will **not** receive a magic code.
Security Code emails are sent when you log in to Expensify and are critical for account access. These emails may be delayed or blocked due to spam filtering, corporate email policies, or server-level blocks. If you choose to or are automatically directed to sign in via SAML/SSO, you will **not** receive a security code.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Terminology casing inconsistency: This line renames the term to "Security Code" but ends with lowercase "security code" ("you will not receive a security code"). Per HELPSITE_NAMING_CONVENTIONS.md, match capitalization exactly and be consistent. Capitalize as Security Code to match the rest of the diff.


## Quick Fixes for Users

If you're not receiving your Magic Code email:
If you're not receiving your Security Code email:

1. **Wait up to 10 minutes** - Magic Codes may be delayed due to email processing
1. **Wait up to 10 minutes** - Security Codes may be delayed due to email processing
2. **Check spam/junk folders** - Search for emails from "expensify.com" or "concierge@expensify.com"
3. **Search your entire inbox** for "Expensify" to find filtered messages
4. **Add concierge@expensify.com to your contacts** to prevent future filtering
Expand All @@ -29,7 +29,7 @@ If you're not receiving your Magic Code email:

## When to Escalate

Contact Expensify Concierge if you've tried the above steps and still can't receive Magic Codes. Include:
Contact Expensify Concierge if you've tried the above steps and still can't receive Security Codes. Include:
- Your email domain (e.g., @company.com)
- Timestamp of your login attempt
- Any bounce or SMTP error messages you received
Expand Down Expand Up @@ -125,15 +125,15 @@ Even if you have received Expensify Emails in the past, confirm that **expensify

# FAQ

## What if I still don't get my Magic Code after following all the steps?
## What if I still don't get my Security Code after following all the steps?

If you've waited 10+ minutes, checked spam folders, and tried resending but still don't receive your Magic Code:
If you've waited 10+ minutes, checked spam folders, and tried resending but still don't receive your Security Code:

1. **Try an alternate contact method** if you have one configured in your account settings
2. **Contact Expensify Concierge** with your email domain and timestamp of the login attempt
3. **Ask your IT team** to check server logs for blocked messages from expensify.com

## How long should I wait before trying to resend my Magic Code?
## How long should I wait before trying to resend my Security Code?

- **First retry:** Wait at least 2-3 minutes before requesting a new code
- **Subsequent retries:** Wait 5-10 minutes between attempts to avoid overwhelming email filters
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ If you're having trouble accessing your account, try the following:
- **Check your internet connection** – Ensure you're connected to a stable network.
- **Force a clean sign-out** – [Click here](https://www.expensify.com/signout.php?clean=true) to force a clean sign out, then try signing in again.
- **Try a different browser or device** – See if the issue persists elsewhere.
- **Troubleshoot Magic Code issues** – If you're not receiving the Magic Code, refer to the [email troubleshooting guide](https://help.expensify.com/articles/expensify-classic/settings/Email-Notifications).
- **Troubleshoot Security Code issues** – If you're not receiving the Security Code, refer to the [email troubleshooting guide](https://help.expensify.com/articles/expensify-classic/settings/Email-Notifications).
- **Troubleshoot 2FA issues** – If you're having trouble with Two-Factor Authentication, check the [2FA troubleshooting guide](https://help.expensify.com/articles/expensify-classic/settings/Two-Factor-Authentication).

**Still having trouble?** Reach out to Concierge and provide the details of the issue you are experiencing.
Expand Down
4 changes: 2 additions & 2 deletions docs/articles/expensify-classic/settings/Merge-Accounts.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,8 +28,8 @@ Make sure you know:
4. Enter the email address or phone number of the account you want to merge.
5. Confirm the action by checking **“Yes, I understand this is not reversible.”**
6. Click **Merge Accounts**.
7. Check the inbox of the email you're merging in for a Magic Code.
8. Enter the Magic Code to complete the merge.
7. Check the inbox of the email you're merging in for a Security Code.
8. Enter the Security Code to complete the merge.

---

Expand Down
Loading
Loading