diff --git a/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md b/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md index 0b7210e21b0f..d6bf4a9dbb5e 100644 --- a/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md +++ b/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md @@ -1,8 +1,8 @@ --- title: Merchant Rules description: Learn how to enable and use Merchant Rules to automatically apply consistent expense coding based on the expense merchant name. -keywords: [New Expensify, workspace merchant rules, merchant rules, auto-categorize by merchant, expense automation, expense rules, workspace settings] -internalScope: Audience is Workspace Admins on the Control plan. Covers enabling and using Merchant Rules to apply consistent expense coding based on merchant name. Does not cover personal expense rules, Category Rules, Tag Rules, or troubleshooting rule conflicts. +keywords: [New Expensify, workspace merchant rules, merchant rules, auto-categorize by merchant, expense automation, expense rules, workspace settings, import merchant rules, bulk import merchant rules, merchant rules spreadsheet] +internalScope: Audience is Workspace Admins on the Control plan. Covers enabling, using, and bulk-importing Merchant Rules to apply consistent expense coding based on merchant name. Does not cover personal expense rules, Category Rules, Tag Rules, or troubleshooting rule conflicts. --- # Merchant Rules @@ -29,6 +29,38 @@ To create a Merchant Rule: --- +## How to import Merchant Rules using a spreadsheet + +Instead of adding rules one at a time, you can bulk-import Merchant Rules from a spreadsheet. + +1. In the navigation tabs (on the left on web, and at the bottom on mobile), click **Workspaces > [workspace name]**. +2. Click **Rules**. +3. Click **More**, then select **Import merchant rules**. +4. Select **Choose file** and upload your spreadsheet. +5. Map each column in your spreadsheet to a Merchant Rule field: + - **Merchant is** — match expenses whose merchant exactly matches the value. + - **Merchant contains** — match expenses whose merchant contains the value. + - **Updated merchant** — the merchant name to apply. + - **Updated category** — the category to apply. + - **Updated tag** — the tag to apply. + - **Updated description** — the description to apply. + - **Reimbursable** — set reimbursable status (`true`/`yes` or `false`/`no`). + - **Billable** — set billable status (`true`/`yes` or `false`/`no`). +6. Leave **File contains column headers** enabled if your spreadsheet's first row contains column titles. +7. Click **Import**. + +Each row must map at least one **Merchant is** or **Merchant contains** column, plus at least one field to update. If a row fills both **Merchant is** and **Merchant contains**, **Merchant is** takes precedence. Rows without a merchant match value are skipped. + + + +**Note:** Importing rules that already exist won't create duplicates — existing Merchant Rules are skipped. + +--- + ## How Merchant Rules are applied Each Merchant Rule matches expenses using either **Matches exactly** or **Contains**.