Skip to content
Open
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
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
---
title: Expensify Card Spend Rules
description: Create spend rules to automatically approve or decline Expensify Card transactions in real time based on merchants, spend categories, or max amounts.
keywords: [spend rules, Expensify Card rules, card restrictions, block merchants, allow merchants, spend categories, max amount, card spend limits, real-time card controls]
internalScope: Audience is Workspace Admins on the Control plan with Expensify Cards enabled. Covers creating and managing spend rules for Expensify Card transactions. Does not cover general workspace expense rules, category rules, or Expensify Card setup and issuance.
---

# Expensify Card Spend Rules

Spend rules let Workspace Admins control Expensify Card transactions in real time. You can create rules that automatically approve or decline charges based on merchants, spend categories, or maximum amounts. These rules apply at the time of purchase, not after the expense is submitted.

Expensify Cards include built-in protections that always block charges for adult services, ATMs, gambling, and money transfers. You can add custom spend rules to further protect company cash flow.

---

## Who can use Expensify Card Spend Rules

- You must be a **Workspace Admin** on the **Control** plan.
- **Expensify Cards** must be enabled and issued in the workspace.
- **Rules** must be enabled under **More Features**.

---

## How to view built-in Expensify Card protections

Expensify Cards always decline charges in these categories:

- Adult services
- ATMs
- Gambling
- Money transfers

To view these protections:

1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**.
2. Click your **workspace name**.
3. Click **Rules**.
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: Per HELPSITE_NAMING_CONVENTIONS.md, the unified navigation instruction should follow this format: "Click the navigation tabs (on the left on web, on the bottom on mobile)." The current phrasing restructures this as "In the navigation tabs... click Workspaces" and adds "and" before "at the bottom."

Suggested fix:

Suggested change
3. Click **Rules**.
1. Click **Workspaces** in the navigation tabs (on the left on web, on the bottom on mobile).

4. Scroll to the **Spend** section.
5. Click the built-in protection rule to see details.

---

## How to add a custom Expensify Card Spend Rule

1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**.
2. Click your **workspace name**.
3. Click **Rules**.
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: Same as above — align with governance format.

Suggested fix:

Suggested change
3. Click **Rules**.
1. Click **Workspaces** in the navigation tabs (on the left on web, on the bottom on mobile).

4. Scroll to the **Spend** section.
5. Click **Add spend rule**.
6. Select the cards this rule applies to, then click **Next**.
Comment on lines +49 to +50
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Restrict custom-rule instructions to current rollout scope

This article instructs admins to click Add spend rule, but that action is not available in production today: src/pages/workspace/rules/SpendRules/SpendRulesSection.tsx renders the add button only when !isProduction (lines 265–275). Because this is a public help page under docs/articles/new-expensify/..., production users will hit a dead-end flow and be unable to follow the documented steps. Please gate the documentation to beta/non-production users or remove the creation steps until production exposes the button.

Useful? React with 👍 / 👎.

7. Configure the rule:
- **Restriction type** - Choose **Allow** (approve matching charges) or **Block** (decline matching charges).
- **Merchants** - Add merchant names using **Contains** or **Matches exactly** matching.
- **Spend category** - Select one or more spend categories (e.g., Airlines, Dining, Hotels, Retail).
- **Max amount** - Set a maximum charge amount. Any charge over this amount is declined regardless of other rule settings. All selected cards must settle in the same currency to set a max amount.
8. Click **Save rule**.

---

## How Expensify Card Spend Rules work

- **Allow rules** approve charges that match any specified merchant or spend category and do not exceed the max amount.
- **Block rules** decline charges that match any specified merchant or spend category, or exceed the max amount.
- Rules are evaluated in real time when the card is used for a purchase.
- Each rule can apply to specific cards or all Expensify Cards in the workspace.
- Multiple spend rules can exist at the same time.

---

# FAQ

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

The **Spend** section only appears when Expensify Cards are enabled for the workspace. To enable Expensify Cards, go to **Workspaces** > your **workspace name** > **More Features** and toggle on **Expensify Card**.

## Can I set a max amount with cards in different currencies?

No. To set a max amount, all selected cards must settle in the same currency. If your selected cards settle in different currencies, you will be prompted to review the selected cards.

## What spend categories are available for Spend Rules?

Available spend categories include Airlines, Alcohol and bars, Amazon and bookstores, Automotive, Car rentals, Dining, Fuel and gas, Government and non-profits, Groceries, Gyms and fitness, Healthcare, Hotels, Internet and phone, Office supplies, Parking and tolls, Professional services, Retail, Shipping and delivery, Software, Transit and rideshare, and Travel agencies.
11 changes: 11 additions & 0 deletions docs/articles/new-expensify/workspaces/Workspace-Rules.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,17 @@ To enable it:

---

# How to configure Expensify Card Spend Rules
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 level violation: Per HELP_AUTHORING_GUIDELINES.md Section 4, articles must have "exactly one # heading (the article title). No other # headings are allowed except # FAQ." This should be demoted to ## to comply with governance rules.

Note: The existing file already uses multiple # headings (a pre-existing pattern), but governance specifies only ## for content sections below the title. Consider addressing this across the file in a follow-up.


Spend Rules let you control Expensify Card transactions in real time by automatically approving or declining charges based on merchants, spend categories, or maximum amounts. Expensify Cards include built-in protections that always block charges for adult services, ATMs, gambling, and money transfers.

The **Spend** section appears on the Rules page when Expensify Cards are enabled for the workspace.

To learn how to create and manage Spend Rules, see:
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.

Cross-link violation: Per HELP_AUTHORING_GUIDELINES.md Section 7 (Link Formatting), "Use relative links only. Do not use full URLs."

Replace:

Suggested change
To learn how to create and manage Spend Rules, see:
[**Expensify Card Spend Rules**](/articles/new-expensify/workspaces/Expensify-Card-Spend-Rules)

[**Expensify Card Spend Rules**](https://help.expensify.com/articles/new-expensify/workspaces/Expensify-Card-Spend-Rules)

---

# How to configure Expense Report rules

Use these settings to control how entire reports are named, routed, and approved.
Expand Down
Loading