Skip to content
Merged
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
39 changes: 37 additions & 2 deletions docs/articles/new-expensify/workspaces/Workspace-Rules.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: Workspace Rules
description: Configure and manage rules for your workspace to enforce expense policies and automate compliance.
keywords: [New Expensify, workspace rules, expense rules, receipt requirements, category rules, self-approvals, prohibited expenses, disable Smartscan, automate expenses, subscription expense, non-reimbursable, default expense handling, control expenses, expense categorization, rule-based expenses, compliance, itemized receipt, itemized receipts required over, merchant rules, workspace merchant rules, auto-categorize by merchant]
internalScope: Audience is Workspace Admins on the Control plan. Covers enabling and managing workspace-level rules such as expense rules, prohibited expenses, category rules, tag rules, and report rules. Does not cover personal expense rules, Workspace Merchant Rules setup details, or troubleshooting specific rule outcomes.
keywords: [New Expensify, workspace rules, expense rules, receipt requirements, category rules, self-approvals, prohibited expenses, disable Smartscan, automate expenses, subscription expense, non-reimbursable, default expense handling, control expenses, expense categorization, rule-based expenses, compliance, itemized receipt, itemized receipts required over, merchant rules, workspace merchant rules, auto-categorize by merchant, spend rules, Expensify Card spend rules, block transactions, approve transactions]
internalScope: Audience is Workspace Admins on the Control plan. Covers enabling and managing workspace-level rules such as expense rules, merchant rules, prohibited expenses, category rules, tag rules, report rules, and Expensify Card spend rules. Does not cover personal expense rules, Workspace Merchant Rules setup details, or troubleshooting specific rule outcomes.
---

# Workspace Rules
Expand Down Expand Up @@ -68,6 +68,37 @@ To learn how to set up and manage Workspace Merchant Rules, see:

---

# How to configure Spend rules for Expensify Cards

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 hierarchy violation: Per HELP_AUTHORING_GUIDELINES.md Section 4 and the Pre-Publish Validation Checklist, only one # heading (the article title) is allowed, plus an optional # FAQ. All content sections must use ##. This should be ## How to configure Spend rules for Expensify Cards.

(Note: the existing file has the same issue with other # headings — those are pre-existing violations outside this PR's scope, but new content should follow the standard.)


Spend rules let Workspace Admins approve or decline Expensify Card transactions in realtime based on the merchant, spend category, and amount of each charge. They appear in the **Spend** section of the **Rules** tab and only show after the [Expensify Card](/articles/new-expensify/expensify-card/Set-Up-and-Manage-the-Expensify-Card) is enabled for the workspace.

Every Expensify Card includes built-in protection that always declines these charges:
- Adult services
- ATMs
- Gambling
- Money transfers

To add your own spend rule:

1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**.

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.

Navigation phrasing violation: Per HELPSITE_NAMING_CONVENTIONS.md, the standard unified navigation instruction is:

In the navigation tabs (on the left on web, on the bottom on mobile)

The phrase should be "on the bottom on mobile" not "at the bottom on mobile".

Suggested change
1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**.
1. In the **navigation tabs** (on the left on web, and on the bottom on mobile), click **Workspaces**.

2. Click your **workspace name**.
3. Click **Rules**.
4. In the **Spend** section, click **Add spend rule**.
5. Set the **Restriction type**:
- **Allow** – Charges are approved if they match any merchant or category, and don't exceed a max amount.
- **Block** – Charges are declined if they match any merchant or category, or exceed a max amount.
6. (Optional) Click **Add merchant** to restrict by merchant name, then choose a **Match type** of **Contains** or **Matches exactly**.
7. (Optional) Set a **Spend category** to restrict.
8. (Optional) Set a **Max amount**. Any charge over this amount is declined, regardless of the merchant and spend category restrictions.
9. Click **Choose cards** to select which Expensify Cards the rule applies to.
10. Click **Save rule**.

To edit or delete an existing rule, click the rule in the **Spend** section, make your changes, and click **Save rule** or **Delete rule**.

You can also apply a spend rule to a card while [issuing a new Expensify Card](/articles/new-expensify/expensify-card/Set-Up-and-Manage-the-Expensify-Card).

---

# How to configure the Prohibited Expenses Rule

Use this AI-powered rule to flag receipts with restricted purchases.
Expand Down Expand Up @@ -175,6 +206,10 @@ This violation is triggered when an expense meets **any** of the following condi

The **Require Company Card for All Purchases** rule only appears after at least one company card feed is connected to the workspace. If all company card feeds are removed, the rule will automatically disable.

## Why don't I see the Spend section in Rules?

The **Spend** section only appears after the Expensify Card is enabled for the workspace. Enable it under **Workspaces > [Workspace Name] > More features**, then return to the **Rules** tab.

## What happens if I disable eReceipts?

Disabling eReceipts hides any previously generated eReceipts. Re-enabling the feature will restore those receipts.
Expand Down
Loading