From 3664d6cb0937077f44bc89141d161d051e72eabf Mon Sep 17 00:00:00 2001
From: Stephanie Elliott <31225194+stephanieelliott@users.noreply.github.com>
Date: Mon, 15 Dec 2025 13:01:59 -1000
Subject: [PATCH 1/4] Create Troubleshoot-Expensify-Card.md
---
.../Troubleshoot-Expensify-Card.md | 91 +++++++++++++++++++
1 file changed, 91 insertions(+)
create mode 100644 docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md
diff --git a/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md b/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md
new file mode 100644
index 000000000000..a93bf6b4621c
--- /dev/null
+++ b/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md
@@ -0,0 +1,91 @@
+---
+title: How to Troubleshoot Expensify Card Issues
+description: Learn how to fix common problems with your Expensify Card, including declined transactions, card activation issues, and Smart Limit errors.
+keywords: [Expensify Card, card declined, Smart Limit, inactive card, activation issues, card won’t work]
+---
+
+If your Expensify Card isn’t working — maybe it’s being declined, showing as inactive, or not activating at all — don’t worry! This guide covers the most common issues and how to get your card working again.
+
+---
+
+# Who can troubleshoot Expensify Card problems
+
+- **Cardholders** can check their card status and spending limit under **Account > Wallet > Expensify Card**.
+- **Workspace Admins** can manage cards, adjust limits, and review settings under **Workspaces > [Workspace Name] > Expensify Card**
+---
+
+# Common reasons your Expensify Card might not work
+
+If your card is declined or showing as inactive, it’s usually due to one of the following:
+
+### Your card hasn’t been activated
+- On your account homepage, you’ll see an **Activate your Expensify Card** task.
+- Follow the prompt and enter the last 4 digits of your card to activate it.
+
+### You’ve hit your Smart Limit
+Your Smart Limit is the amount you’re allowed to spend without approved expenses. If you try to make a purchase that exceeds this limit, the transaction will be declined. This limit is set and managed by your workspace admin.
+To view your current limit:
+
+ 1. From the navigation tabs (on the left on web, and at the bottom on mobile), select Account > Wallet.
+ 2. Click your Expensify Card to view your Smart Limit.
+
+### Your card is Inactive
+- This means the the card has been canceled, or has been set a $0 limit by a workspace admin.
+- Contact your Workspace Admin to check your card status, or reach out to Concierge for help
+
+### There’s an issue with your workspace’s limit
+- Each workspace has a shared **domain limit** that affects all cards.
+- If the domain limit runs out, everyone’s card may temporarily stop working.
+- This can happen if large purchases haven’t settled yet or if there’s a bank issue. Contact your workspace admin for help with this.
+
+---
+
+# Steps you can take to fix card problems
+
+## If you’re a cardholder:
+- Go to `Account > Wallet > Expensify Card`
+- Check to make sure you have a positive **Smart Limit**
+- Submit any open reports to refresh your limit
+
+## If you’re a Workspace Admin:
+- Go to `Workspaces > [Workspace Name] > Expensify Card`
+- Check each card’s status
+- Review the overall domain limit and bank connection
+- Adjust Smart Limits or reissue cards if needed
+
+---
+
+# What do terms like "INACTIVE" or "Smart Limit inactive" mean?
+
+- **INACTIVE**: Your card hasn’t been activated yet, or it was paused due to an issue (like a failed settlement or zero spending limit).
+- **Smart Limit inactive**: The card exists, but there’s no available spending — either due to a $0 limit or no funds in the workspace’s overall domain limit.
+
+---
+
+# FAQ
+
+## Why is my card being declined?
+
+- Your Smart Limit may be used up.
+- The card hasn’t been activated.
+- The workspace’s domain limit is temporarily unavailable.
+
+## What should I do if the card says INACTIVE?
+
+Try activating it under `Account > Wallet > Expensify Card`. If it’s still inactive, contact your Workspace Admin to check your setup.
+
+## How do I restore my Smart Limit?
+
+Submit your expenses! As reports are approved, your Smart Limit is refreshed.
+
+## Can one issue affect all cards?
+
+Yes — if the domain limit runs out or a bank settlement fails, all cards may pause until the issue is resolved:contentReference[oaicite:3]{index=3}.
+
+## Where can Admins check for account-level issues?
+
+Go to:
+- `Workspaces > [Workspace Name] > Expensify Card > Settings`
+- Look for warnings or alerts about the bank connection, limits, or settlement delays.
+
+
From bef9c146f6e5b56fdade12f136f8729bb948c582 Mon Sep 17 00:00:00 2001
From: Stephanie Elliott <31225194+stephanieelliott@users.noreply.github.com>
Date: Tue, 30 Dec 2025 23:04:13 -1000
Subject: [PATCH 2/4] Update Troubleshoot-Expensify-Card.md
---
.../Troubleshoot-Expensify-Card.md | 106 +++++++++---------
1 file changed, 55 insertions(+), 51 deletions(-)
diff --git a/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md b/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md
index a93bf6b4621c..24f62ccb3836 100644
--- a/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md
+++ b/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md
@@ -1,91 +1,95 @@
---
title: How to Troubleshoot Expensify Card Issues
description: Learn how to fix common problems with your Expensify Card, including declined transactions, card activation issues, and Smart Limit errors.
-keywords: [Expensify Card, card declined, Smart Limit, inactive card, activation issues, card won’t work]
+keywords: [Expensify Card, card declined, Smart Limit, inactive card, activation issues, card won’t work, workspace admin, cardholder, Wallet, domain limit]
---
-If your Expensify Card isn’t working — maybe it’s being declined, showing as inactive, or not activating at all — don’t worry! This guide covers the most common issues and how to get your card working again.
+
+
+You can troubleshoot most Expensify Card issues in just a few steps. This guide walks you through the most common problems — like declined transactions, activation issues, or Smart Limit errors — and shows how to get your card working again.
---
-# Who can troubleshoot Expensify Card problems
+# Who can troubleshoot Expensify Card issues
+
+- **Cardholders** can view their assigned card(s), check activation status, and see their available limit.
+- **Workspace Admins** can view and manage all cards on the workspace, adjust card limits, deactivate cards, and monitor the overall domain limit.
-- **Cardholders** can check their card status and spending limit under **Account > Wallet > Expensify Card**.
-- **Workspace Admins** can manage cards, adjust limits, and review settings under **Workspaces > [Workspace Name] > Expensify Card**
---
-# Common reasons your Expensify Card might not work
+# Where to find Expensify Card settings
-If your card is declined or showing as inactive, it’s usually due to one of the following:
+## Cardholders
-### Your card hasn’t been activated
-- On your account homepage, you’ll see an **Activate your Expensify Card** task.
-- Follow the prompt and enter the last 4 digits of your card to activate it.
+- **On web:** Go to **Account > Wallet > Expensify Card** using the navigation tabs on the left.
+- **On mobile:** Tap the navigation tabs at the bottom and go to **Wallet > Expensify Card**.
-### You’ve hit your Smart Limit
-Your Smart Limit is the amount you’re allowed to spend without approved expenses. If you try to make a purchase that exceeds this limit, the transaction will be declined. This limit is set and managed by your workspace admin.
-To view your current limit:
+## Workspace Admins
- 1. From the navigation tabs (on the left on web, and at the bottom on mobile), select Account > Wallet.
- 2. Click your Expensify Card to view your Smart Limit.
+- **On web:** Go to **Workspaces > [Workspace Name] > Expensify Card** using the navigation tabs on the left.
+- **On mobile:** Tap the **menu icon** in the top-left corner, then select **Workspaces > [Workspace Name] > Expensify Card**.
-### Your card is Inactive
-- This means the the card has been canceled, or has been set a $0 limit by a workspace admin.
-- Contact your Workspace Admin to check your card status, or reach out to Concierge for help
+---
-### There’s an issue with your workspace’s limit
-- Each workspace has a shared **domain limit** that affects all cards.
-- If the domain limit runs out, everyone’s card may temporarily stop working.
-- This can happen if large purchases haven’t settled yet or if there’s a bank issue. Contact your workspace admin for help with this.
+# What to check if your Expensify Card is not working
----
+## Your Expensify Card hasn’t been activated
-# Steps you can take to fix card problems
+To check if your card is active:
-## If you’re a cardholder:
-- Go to `Account > Wallet > Expensify Card`
-- Check to make sure you have a positive **Smart Limit**
-- Submit any open reports to refresh your limit
+- **On web:** Go to **Account > Wallet > Expensify Card** using the navigation tabs on the left.
+- **On mobile:** Go to **Wallet > Expensify Card** using the navigation tabs at the bottom.
-## If you’re a Workspace Admin:
-- Go to `Workspaces > [Workspace Name] > Expensify Card`
-- Check each card’s status
-- Review the overall domain limit and bank connection
-- Adjust Smart Limits or reissue cards if needed
+Then, click on your card. If it hasn’t been activated yet, you’ll see an **Activate physical card** prompt at the bottom of the screen. Follow the steps to complete activation.
----
+## You’ve reached your card’s spend limit
+
+Each Expensify Card has a spending limit set by your Workspace Admin. If your available limit is too low, your transactions may be declined.
+
+To check your card’s remaining limit:
-# What do terms like "INACTIVE" or "Smart Limit inactive" mean?
+- **On web:** Go to **Account > Wallet > Expensify Card** using the navigation tabs on the left.
+- **On mobile:** Go to **Wallet > Expensify Card** using the navigation tabs at the bottom.
-- **INACTIVE**: Your card hasn’t been activated yet, or it was paused due to an issue (like a failed settlement or zero spending limit).
-- **Smart Limit inactive**: The card exists, but there’s no available spending — either due to a $0 limit or no funds in the workspace’s overall domain limit.
+Then, click on your card. Your **remaining limit** is displayed under the image of your Expensify Card.
+
+## Your workspace’s domain limit has run out
+
+Every workspace has a shared **domain limit** that affects all cards. If the workspace runs out of available funds or the bank account becomes [locked](https://help.expensify.com/articles/new-expensify/wallet-and-payments/Unlock-a-Business-Bank-Account), all cards may stop working.
+
+Workspace Admins can check the available domain limit by going to **Workspaces > [Workspace Name] > Expensify Card**. From there, they can view the current balance, remaining limit, and any warnings related to settlement.
---
# FAQ
-## Why is my card being declined?
+## How can I refresh the limit on my Expensify Card?
-- Your Smart Limit may be used up.
-- The card hasn’t been activated.
-- The workspace’s domain limit is temporarily unavailable.
+There are three types of limits that Workspace Admins can set:
-## What should I do if the card says INACTIVE?
+- **Smart Limit:** Spend up to a certain amount before approval is required. This refreshes when the expenses are submitted and approved.
+- **Monthly limit:** Spend up to a set amount per month. It refreshes automatically on the first of each month.
+- **Fixed amount:** Spend up to a set amount once. This does **not** refresh.
-Try activating it under `Account > Wallet > Expensify Card`. If it’s still inactive, contact your Workspace Admin to check your setup.
+You can view your limit type below your spending limit when viewing your card.
-## How do I restore my Smart Limit?
+## Can one issue affect all Expensify Cards in a workspace?
-Submit your expenses! As reports are approved, your Smart Limit is refreshed.
+Yes. If the domain limit runs out or a bank account becomes locked due to a failed settlement, all cards in the workspace may be paused temporarily.
-## Can one issue affect all cards?
+## How can a Workspace Admin check for workspace-level problems affecting Expensify Cards?
-Yes — if the domain limit runs out or a bank settlement fails, all cards may pause until the issue is resolved:contentReference[oaicite:3]{index=3}.
+Workspace Admins can check the domain limit at **Workspaces > [Workspace Name] > Expensify Card**, under **Remaining limit**.
+To check for bank account issues, navigate to **Workspaces > [Workspace Name] > Bank Account**, then click the **Fix** button next to any locked account.
-## Where can Admins check for account-level issues?
-Go to:
-- `Workspaces > [Workspace Name] > Expensify Card > Settings`
-- Look for warnings or alerts about the bank connection, limits, or settlement delays.
+## How can a Workspace Admin refresh the workspace’s Expensify Card limit?
+
+The workspace limit refreshes automatically after the workspace's regular Expensify Card settlement. To refresh it earlier:
+
+1. Go to **Workspaces > [Workspace Name] > Expensify Card**
+2. Click **Settle Balance** to trigger an early settlement.
+3. Once the settlement clears, the domain limit will be refreshed.
+
From 4fc1ee454fc74b20932911747b1def2d885bec4d Mon Sep 17 00:00:00 2001
From: Stephanie Elliott <31225194+stephanieelliott@users.noreply.github.com>
Date: Tue, 30 Dec 2025 23:07:30 -1000
Subject: [PATCH 3/4] Rename Troubleshoot-Expensify-Card.md to
Troubleshoot-Expensify-Card-issues.md
---
...ot-Expensify-Card.md => Troubleshoot-Expensify-Card-issues.md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
rename docs/articles/new-expensify/expensify-card/{Troubleshoot-Expensify-Card.md => Troubleshoot-Expensify-Card-issues.md} (100%)
diff --git a/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md b/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card-issues.md
similarity index 100%
rename from docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card.md
rename to docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card-issues.md
From da16900b7d88dbd51280007b51e65ef5120a304d Mon Sep 17 00:00:00 2001
From: Stephanie Elliott <31225194+stephanieelliott@users.noreply.github.com>
Date: Tue, 30 Dec 2025 23:13:39 -1000
Subject: [PATCH 4/4] Update Troubleshoot-Expensify-Card-issues.md
---
.../Troubleshoot-Expensify-Card-issues.md | 24 +++++++++----------
1 file changed, 12 insertions(+), 12 deletions(-)
diff --git a/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card-issues.md b/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card-issues.md
index 24f62ccb3836..a87894eb8247 100644
--- a/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card-issues.md
+++ b/docs/articles/new-expensify/expensify-card/Troubleshoot-Expensify-Card-issues.md
@@ -13,7 +13,7 @@ You can troubleshoot most Expensify Card issues in just a few steps. This guide
# Who can troubleshoot Expensify Card issues
- **Cardholders** can view their assigned card(s), check activation status, and see their available limit.
-- **Workspace Admins** can view and manage all cards on the workspace, adjust card limits, deactivate cards, and monitor the overall domain limit.
+- **Workspace Admins** can view and manage all cards on the workspace, adjust card limits, deactivate cards, and monitor the overall workspace limit.
---
@@ -33,7 +33,7 @@ You can troubleshoot most Expensify Card issues in just a few steps. This guide
# What to check if your Expensify Card is not working
-## Your Expensify Card hasn’t been activated
+## Expensify Card not activated
To check if your card is active:
@@ -42,7 +42,7 @@ To check if your card is active:
Then, click on your card. If it hasn’t been activated yet, you’ll see an **Activate physical card** prompt at the bottom of the screen. Follow the steps to complete activation.
-## You’ve reached your card’s spend limit
+## Expensify Card spend limit reached
Each Expensify Card has a spending limit set by your Workspace Admin. If your available limit is too low, your transactions may be declined.
@@ -53,17 +53,17 @@ To check your card’s remaining limit:
Then, click on your card. Your **remaining limit** is displayed under the image of your Expensify Card.
-## Your workspace’s domain limit has run out
+## Workspace limit has run out
-Every workspace has a shared **domain limit** that affects all cards. If the workspace runs out of available funds or the bank account becomes [locked](https://help.expensify.com/articles/new-expensify/wallet-and-payments/Unlock-a-Business-Bank-Account), all cards may stop working.
+Every workspace has a shared spend limit that affects all cards. If the workspace runs out of available funds or the bank account becomes [locked](https://help.expensify.com/articles/new-expensify/wallet-and-payments/Unlock-a-Business-Bank-Account), all cards may stop working.
-Workspace Admins can check the available domain limit by going to **Workspaces > [Workspace Name] > Expensify Card**. From there, they can view the current balance, remaining limit, and any warnings related to settlement.
+Workspace Admins can check the available limit by going to **Workspaces > [Workspace Name] > Expensify Card**. From there, Workspace Admins can view the current balance, remaining limit, and any warnings related to settlement.
---
# FAQ
-## How can I refresh the limit on my Expensify Card?
+## How do I refresh the limit on my Expensify Card?
There are three types of limits that Workspace Admins can set:
@@ -75,21 +75,21 @@ You can view your limit type below your spending limit when viewing your card.
## Can one issue affect all Expensify Cards in a workspace?
-Yes. If the domain limit runs out or a bank account becomes locked due to a failed settlement, all cards in the workspace may be paused temporarily.
+Yes. If the workspace limit runs out or a bank account becomes locked due to a failed settlement, all cards in the workspace may be paused temporarily.
-## How can a Workspace Admin check for workspace-level problems affecting Expensify Cards?
+## How does a Workspace Admin check for workspace-level problems affecting Expensify Cards?
-Workspace Admins can check the domain limit at **Workspaces > [Workspace Name] > Expensify Card**, under **Remaining limit**.
+Workspace Admins can check the workspace limit at **Workspaces > [Workspace Name] > Expensify Card**, under **Remaining limit**.
To check for bank account issues, navigate to **Workspaces > [Workspace Name] > Bank Account**, then click the **Fix** button next to any locked account.
-## How can a Workspace Admin refresh the workspace’s Expensify Card limit?
+## How does a Workspace Admin refresh the workspace’s Expensify Card limit?
The workspace limit refreshes automatically after the workspace's regular Expensify Card settlement. To refresh it earlier:
1. Go to **Workspaces > [Workspace Name] > Expensify Card**
2. Click **Settle Balance** to trigger an early settlement.
-3. Once the settlement clears, the domain limit will be refreshed.
+3. Once the settlement clears, the workspace limit will be refreshed.