From da01156d1231c12307025acb2a0af71f45789599 Mon Sep 17 00:00:00 2001 From: "Krishna (via MelvinBot)" Date: Mon, 7 Sep 2026 11:15:51 +0000 Subject: [PATCH 1/5] Docs: document category default tax rates in Rules > Expense defaults Adds a help article for setting a category's default tax rate from the Expense defaults tab, and cross-links it from Workspace Rules and Merchant Rules. Co-authored-by: Krishna --- .../Set-a-default-tax-rate-for-a-category.md | 100 ++++++++++++++++++ .../workspaces/Workspace-Merchant-Rules.md | 6 +- .../workspaces/Workspace-Rules.md | 2 +- 3 files changed, 105 insertions(+), 3 deletions(-) create mode 100644 docs/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category.md diff --git a/docs/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category.md b/docs/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category.md new file mode 100644 index 000000000000..ece60d478575 --- /dev/null +++ b/docs/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category.md @@ -0,0 +1,100 @@ +--- +title: Set a default tax rate for a category +description: Learn how Workspace Admins set a default tax rate for a category from the Expense defaults tab in Rules, and how that rate is applied to new expenses. +keywords: [New Expensify, category tax rate, default tax rate, category tax default, expense defaults, workspace rules, apply expense defaults, tax rules, category rules] +internalScope: Audience is Workspace Admins on the Control plan with Rules and Taxes enabled. Covers creating, editing, and deleting a category's default tax rate from the Expense defaults tab in Rules. Does not cover creating tax rates, Merchant Rules, or the workspace and foreign currency default tax rates. +--- + +# Set a default tax rate for a category + +A category default tax rate applies a tax rate automatically whenever a new expense is coded with that category, so members don't have to pick a rate themselves. Each rule matches on one category and sets one default: **Tax**. + +Category default tax rates only apply to expenses created after the rule is saved. Expenses that already exist don't change. + +--- + +## Who can set a default tax rate for a category + +To set a default tax rate for a category, you must be: + +- A Workspace Admin. +- On a workspace with **Rules** enabled (available on the Control plan). +- On a workspace with **Taxes** enabled and at least one tax rate created. + +If **Rules** is not enabled, [learn how to enable Workspace Rules](/articles/new-expensify/workspaces/Workspace-Rules). If **Taxes** is not enabled, or the workspace has no tax rates yet, [learn how to configure taxes](/articles/new-expensify/workspaces/Track-Taxes). + +Until taxes are enabled, the **Category** option is locked and selecting it shows **Turn on taxes first**. + +--- + +## How to set a default tax rate for a category + +1. In the navigation tabs (on the left on web, on the bottom on mobile), click **Workspaces > [workspace name]**. +2. Click **Rules**. +3. If the **Rules** page shows tabs, select the **Expense defaults** tab. +4. Click **Add rule**. +5. Select **Apply expense defaults**. +6. Under **What should this rule match on?**, select **Category**. +7. Under **If any expense matches:**, click **Category** and select one or more categories. +8. Under **Then apply the following defaults:**, click **Tax** and select the tax rate to apply. +9. Click **Save rule**. + +Selecting several categories at once creates one rule per category, each using the tax rate you picked. To start over before saving, click **Reset**. + + + +If the **Rules** page doesn't show tabs, set the rate from the category instead: click **Categories**, click the category, then set **Default tax rate**. Both paths write the same rule. + +--- + +## How to edit or delete a category's default tax rate + +Saved rules appear under **Categories** on the **Expense defaults** tab, listed as `Category is "[category name]"`. + +- To change the category or the tax rate, click the rule, update **Category** or **Tax**, then click **Save rule**. Changing the category moves the rate to the new category and removes the old rule. +- To remove a single rule, click the rule and then click **Delete rule**. +- To remove several rules at once, select their checkboxes and use the bulk delete action. + +Rows under **Merchant types** are workspace defaults and can't be selected or deleted. + +--- + +## What happens after you set a default tax rate for a category + +- The tax rate is applied when a new expense is created with that category. +- Expenses created before the rule was saved keep their existing tax rate. A category rule can't be applied to existing expenses, so that option is locked and shows **Category rules apply going forward**. +- If you delete the rule, new expenses in that category fall back to the workspace default tax rate. +- If you delete the category or the tax rate the rule uses, the rule is removed with it. +- Renaming the category keeps the rule and moves it to the new name. + +--- + +# FAQ + +## Can a category rule set anything other than a tax rate? + +No. A rule that matches on **Category** sets only **Tax**. To set a category, tag, description, reimbursable status, or billable status automatically, create a rule that matches on **Merchant** instead. [Learn how to create Merchant Rules](/articles/new-expensify/workspaces/Workspace-Merchant-Rules). + +## Why is the Category option locked when I create an expense default? + +The **Category** option requires taxes. Selecting it shows **Turn on taxes first**. Enable **Taxes** in your workspace settings and add at least one tax rate, then create the rule. + +## Why don't I see any rates when I open Tax? + +The workspace has taxes turned off. The picker shows **Taxes are not enabled** with an **Enable taxes** button. Click it, finish enabling taxes, and the rates appear. + +## Is the workspace default tax rate listed when I pick a rate for a category? + +No. A category rule exists to override the workspace default, so that rate isn't offered as a choice and there's no **None** option. Delete the rule instead to fall back to the workspace default. + +## Why did my rule not save? + +Both fields are required. Saving without a category shows **Please select a category**, and saving without a rate shows **Please select a tax rate**. + +## Can auditors change a category's default tax rate? + +No. Auditors can open a rule to view it, but the fields are read-only and there are no **Save rule** or **Delete rule** buttons. diff --git a/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md b/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md index fc371cc720a4..e9809f33a894 100644 --- a/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md +++ b/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md @@ -19,13 +19,15 @@ To create a Merchant Rule: 1. In the navigation tabs (on the left on web, and at the bottom on mobile), click **Workspaces > [workspace name]**. 2. Click **Rules**. -3. In the **Merchant** section, click **Add merchant rule**. +3. In the **Merchant** section, click **Add merchant rule**. If the **Rules** page shows tabs instead, select the **Expense defaults** tab, click **Add rule**, select **Apply expense defaults**, then select **Merchant**. 4. Enter the merchant name and choose how it should match: - **Contains** - **Matches exactly** 5. Select the fields you want the rule to update. 6. Optionally apply the rule to existing unsubmitted expenses and review matching expenses using **Preview matches**. -7. Select **Save Rule** +7. Click **Save rule**. + +A rule that matches on **Merchant** can update any expense field the rule supports. To set only a default tax rate for a category, create a rule that matches on **Category** instead. [Learn how to set a default tax rate for a category](/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category). --- diff --git a/docs/articles/new-expensify/workspaces/Workspace-Rules.md b/docs/articles/new-expensify/workspaces/Workspace-Rules.md index 9c55dbe27396..2bd75a840e77 100644 --- a/docs/articles/new-expensify/workspaces/Workspace-Rules.md +++ b/docs/articles/new-expensify/workspaces/Workspace-Rules.md @@ -143,7 +143,7 @@ To manage them: Available options: - **Approver** – Assign a specific approver for expenses in this category. -- **Default tax rate** – Set a default tax percentage ([Taxes](/articles/new-expensify/workspaces/Track-Taxes) must be enabled on the workspace). +- **Default tax rate** – Set a default tax percentage ([Taxes](/articles/new-expensify/workspaces/Track-Taxes) must be enabled on the workspace). You can also set and manage this rate from the **Expense defaults** tab on the **Rules** page. [Learn how to set a default tax rate for a category](/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category). - **Flag amounts over** - Set a spending cap for this category. - **Require receipts over** – Set a threshold for when receipts are required. - **Require itemized receipts over** – Require itemized receipts for expenses over a specific amount. From fbbd0b1e90c53afefeeebfcff45c738e39e5cfeb Mon Sep 17 00:00:00 2001 From: Stephanie Elliott <31225194+stephanieelliott@users.noreply.github.com> Date: Sun, 27 Sep 2026 18:34:03 -1000 Subject: [PATCH 2/5] Delete docs/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category.md --- .../Set-a-default-tax-rate-for-a-category.md | 100 ------------------ 1 file changed, 100 deletions(-) delete mode 100644 docs/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category.md diff --git a/docs/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category.md b/docs/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category.md deleted file mode 100644 index ece60d478575..000000000000 --- a/docs/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category.md +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: Set a default tax rate for a category -description: Learn how Workspace Admins set a default tax rate for a category from the Expense defaults tab in Rules, and how that rate is applied to new expenses. -keywords: [New Expensify, category tax rate, default tax rate, category tax default, expense defaults, workspace rules, apply expense defaults, tax rules, category rules] -internalScope: Audience is Workspace Admins on the Control plan with Rules and Taxes enabled. Covers creating, editing, and deleting a category's default tax rate from the Expense defaults tab in Rules. Does not cover creating tax rates, Merchant Rules, or the workspace and foreign currency default tax rates. ---- - -# Set a default tax rate for a category - -A category default tax rate applies a tax rate automatically whenever a new expense is coded with that category, so members don't have to pick a rate themselves. Each rule matches on one category and sets one default: **Tax**. - -Category default tax rates only apply to expenses created after the rule is saved. Expenses that already exist don't change. - ---- - -## Who can set a default tax rate for a category - -To set a default tax rate for a category, you must be: - -- A Workspace Admin. -- On a workspace with **Rules** enabled (available on the Control plan). -- On a workspace with **Taxes** enabled and at least one tax rate created. - -If **Rules** is not enabled, [learn how to enable Workspace Rules](/articles/new-expensify/workspaces/Workspace-Rules). If **Taxes** is not enabled, or the workspace has no tax rates yet, [learn how to configure taxes](/articles/new-expensify/workspaces/Track-Taxes). - -Until taxes are enabled, the **Category** option is locked and selecting it shows **Turn on taxes first**. - ---- - -## How to set a default tax rate for a category - -1. In the navigation tabs (on the left on web, on the bottom on mobile), click **Workspaces > [workspace name]**. -2. Click **Rules**. -3. If the **Rules** page shows tabs, select the **Expense defaults** tab. -4. Click **Add rule**. -5. Select **Apply expense defaults**. -6. Under **What should this rule match on?**, select **Category**. -7. Under **If any expense matches:**, click **Category** and select one or more categories. -8. Under **Then apply the following defaults:**, click **Tax** and select the tax rate to apply. -9. Click **Save rule**. - -Selecting several categories at once creates one rule per category, each using the tax rate you picked. To start over before saving, click **Reset**. - - - -If the **Rules** page doesn't show tabs, set the rate from the category instead: click **Categories**, click the category, then set **Default tax rate**. Both paths write the same rule. - ---- - -## How to edit or delete a category's default tax rate - -Saved rules appear under **Categories** on the **Expense defaults** tab, listed as `Category is "[category name]"`. - -- To change the category or the tax rate, click the rule, update **Category** or **Tax**, then click **Save rule**. Changing the category moves the rate to the new category and removes the old rule. -- To remove a single rule, click the rule and then click **Delete rule**. -- To remove several rules at once, select their checkboxes and use the bulk delete action. - -Rows under **Merchant types** are workspace defaults and can't be selected or deleted. - ---- - -## What happens after you set a default tax rate for a category - -- The tax rate is applied when a new expense is created with that category. -- Expenses created before the rule was saved keep their existing tax rate. A category rule can't be applied to existing expenses, so that option is locked and shows **Category rules apply going forward**. -- If you delete the rule, new expenses in that category fall back to the workspace default tax rate. -- If you delete the category or the tax rate the rule uses, the rule is removed with it. -- Renaming the category keeps the rule and moves it to the new name. - ---- - -# FAQ - -## Can a category rule set anything other than a tax rate? - -No. A rule that matches on **Category** sets only **Tax**. To set a category, tag, description, reimbursable status, or billable status automatically, create a rule that matches on **Merchant** instead. [Learn how to create Merchant Rules](/articles/new-expensify/workspaces/Workspace-Merchant-Rules). - -## Why is the Category option locked when I create an expense default? - -The **Category** option requires taxes. Selecting it shows **Turn on taxes first**. Enable **Taxes** in your workspace settings and add at least one tax rate, then create the rule. - -## Why don't I see any rates when I open Tax? - -The workspace has taxes turned off. The picker shows **Taxes are not enabled** with an **Enable taxes** button. Click it, finish enabling taxes, and the rates appear. - -## Is the workspace default tax rate listed when I pick a rate for a category? - -No. A category rule exists to override the workspace default, so that rate isn't offered as a choice and there's no **None** option. Delete the rule instead to fall back to the workspace default. - -## Why did my rule not save? - -Both fields are required. Saving without a category shows **Please select a category**, and saving without a rate shows **Please select a tax rate**. - -## Can auditors change a category's default tax rate? - -No. Auditors can open a rule to view it, but the fields are read-only and there are no **Save rule** or **Delete rule** buttons. From e2c1a279d3ea29534ba10e3e60407acc13fc567c Mon Sep 17 00:00:00 2001 From: Stephanie Elliott <31225194+stephanieelliott@users.noreply.github.com> Date: Sun, 27 Sep 2026 18:35:30 -1000 Subject: [PATCH 3/5] Update Workspace-Rules.md --- docs/articles/new-expensify/workspaces/Workspace-Rules.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/new-expensify/workspaces/Workspace-Rules.md b/docs/articles/new-expensify/workspaces/Workspace-Rules.md index 2426249c637c..96af45817094 100644 --- a/docs/articles/new-expensify/workspaces/Workspace-Rules.md +++ b/docs/articles/new-expensify/workspaces/Workspace-Rules.md @@ -151,7 +151,7 @@ The **Agents** tab holds Agent Rules, which are written in plain language and ru ## How to set rules for a single category - **Approver** – Assign a specific approver for expenses in this category. -- **Default tax rate** – Set a default tax percentage ([Taxes](/articles/new-expensify/workspaces/Track-Taxes) must be enabled on the workspace). You can also set and manage this rate from the **Expense defaults** tab on the **Rules** page. [Learn how to set a default tax rate for a category](/articles/new-expensify/workspaces/Set-a-default-tax-rate-for-a-category). +- **Default tax rate** – Set a default tax percentage ([Taxes](/articles/new-expensify/workspaces/Track-Taxes) must be enabled on the workspace). You can also set and manage this rate from the **Expense defaults** tab on the **Rules** page. - **Flag amounts over** - Set a spending cap for this category. - **Require receipts over** – Set a threshold for when receipts are required. - **Require itemized receipts over** – Require itemized receipts for expenses over a specific amount. From e308905d4f56f0be14e24b7314dddc280e51d5be Mon Sep 17 00:00:00 2001 From: "Krishna (via MelvinBot)" Date: Mon, 28 Sep 2026 04:35:46 +0000 Subject: [PATCH 4/5] Fix: spelling typo in Workspace-Merchant-Rules docs Co-authored-by: Krishna --- .../new-expensify/workspaces/Workspace-Merchant-Rules.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md b/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md index c73e44e8aec1..44de7854e5d8 100644 --- a/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md +++ b/docs/articles/new-expensify/workspaces/Workspace-Merchant-Rules.md @@ -47,7 +47,7 @@ Instead of creating Merchant Rules one at a time, you can import multiple Mercha 4. Click **More**, then select **Import merchant rules**. 5. Select **Choose file** and upload your completed spreadsheet. 6. Map each spreadsheet column to the corresponding Merchant Rule field: - - For **Merchant**, choose how the merchant name should match. **Merchant is** requires an exact match, while **Merchant contains** atches merchants whose names contain the value. + - For **Merchant**, choose how the merchant name should match. **Merchant is** requires an exact match, while **Merchant contains** matches merchants whose names contain the value. 7. Click **Import**. --- From 4bfa4eb5be675f211d07a079aa86856902079eb2 Mon Sep 17 00:00:00 2001 From: Stephanie Elliott <31225194+stephanieelliott@users.noreply.github.com> Date: Sun, 27 Sep 2026 18:37:34 -1000 Subject: [PATCH 5/5] Update Workspace-Rules.md --- docs/articles/new-expensify/workspaces/Workspace-Rules.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/new-expensify/workspaces/Workspace-Rules.md b/docs/articles/new-expensify/workspaces/Workspace-Rules.md index 96af45817094..50fecf255634 100644 --- a/docs/articles/new-expensify/workspaces/Workspace-Rules.md +++ b/docs/articles/new-expensify/workspaces/Workspace-Rules.md @@ -151,7 +151,7 @@ The **Agents** tab holds Agent Rules, which are written in plain language and ru ## How to set rules for a single category - **Approver** – Assign a specific approver for expenses in this category. -- **Default tax rate** – Set a default tax percentage ([Taxes](/articles/new-expensify/workspaces/Track-Taxes) must be enabled on the workspace). You can also set and manage this rate from the **Expense defaults** tab on the **Rules** page. +- **Default tax rate** – Set a default tax rate if Taxes enabled on the workspace). - **Flag amounts over** - Set a spending cap for this category. - **Require receipts over** – Set a threshold for when receipts are required. - **Require itemized receipts over** – Require itemized receipts for expenses over a specific amount.