From d71287b255c3c245fca3b0644a9570cd45a204c1 Mon Sep 17 00:00:00 2001 From: Stephanie Elliott <31225194+stephanieelliott@users.noreply.github.com> Date: Fri, 6 Mar 2026 16:55:49 -1000 Subject: [PATCH 1/2] Update and rename Create-expense-tags.md to Create-and-manage-expense-tags.md --- .../Create-and-manage-expense-tags.md | 198 ++++++++++++++++++ .../workspaces/Create-expense-tags.md | 170 --------------- 2 files changed, 198 insertions(+), 170 deletions(-) create mode 100644 docs/articles/new-expensify/workspaces/Create-and-manage-expense-tags.md delete mode 100644 docs/articles/new-expensify/workspaces/Create-expense-tags.md diff --git a/docs/articles/new-expensify/workspaces/Create-and-manage-expense-tags.md b/docs/articles/new-expensify/workspaces/Create-and-manage-expense-tags.md new file mode 100644 index 000000000000..bdaeb474205f --- /dev/null +++ b/docs/articles/new-expensify/workspaces/Create-and-manage-expense-tags.md @@ -0,0 +1,198 @@ +--- +title: Create and Manage Expense Tags +description: Add tags to use for coding expenses. +keywords: [New Expensify, expense tags, class tracking, cost center, import tags, coding expenses, tag GL code] +internalScope: Audience is Workspace Admins. Covers enabling, creating, importing, activating, and managing expense tags, including multi-level tags and tag GL codes. Does not cover personal expense rules or accounting system configuration. +--- + +# Create and Manage Expense Tags + +Tags help you code expenses for accounting and reporting (for example: cost centers, classes, projects, locations, customers, or jobs). + +Workspace Admins can: +- Create tags manually. +- Import tags using a spreadsheet. +- Sync tags from an accounting integration (for example: QuickBooks Online, Xero, NetSuite, Sage Intacct). + +Over time, Expensify also learns your tag preferences and applies them automatically. + +![The Tags tab]({{site.url}}/assets/images/NewExpensify_ManageTags_3.png){:width="100%"} + +--- + +## How to enable Tags on a workspace + +Before you can manage tags, you need to enable the **Tags** feature for your workspace. + +1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]**. +2. Select **More Features**. +3. In the **Organize** section, enable **Tags**. + +--- + +## How to create a tag manually + +1. In the navigation tabs (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]** +2. Select **Tags**. +3. Choose **Add tag** +4. Enter a tag name and select **Save**. + +--- + +## How to import single-level Tags using a spreadsheet + +Use this option when you want one flat list of tags (for example: Marketing, Sales, IT). + +1. In the navigation tabs (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]** +2. Select **Tags**. +3. Select **More** > **Import spreadsheet** + - If no tags exist yet, select **Import** from the Tags page. +4. Choose **Single level of tags**. +5. Select **Choose file** then upload your spreadsheet. +6. Map the required columns: + - Name + - Enabled + - Tag GL Code (Optional) +7. Select **Import**. + +**Note:** Importing a new file will replace your existing tag list. + +--- + +## How to import multi-level Tags using a spreadsheet + +Use this option when you want multiple tag levels (for example: Department and Location). Multi-level tags are available on Control workspaces only. + +1. In the navigation tabs (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]**. +2. Select **Tags**. +3. Select **More** > **Import spreadsheet**. + - If no tags exist yet, select **Import** from the Tags page. +4. Choose **Multi-level tags**. +5. Select **Choose file** then upload your file. +6. Confirm the import settings: + - The first row is the title for each tag list + - These are independent tags + - There is a GL code in the adjacent column (if applicable) +7. Select **Import**. + +The linked templates can be used to import multi-level tags: +- [Dependent tags with GL codes](https://help.expensify.com/assets/Files/Dependent+with+GL+codes+format.csv) +- [Dependent tags without GL codes](https://help.expensify.com/assets/Files/Dependent+without+GL+codes+format.csv) +- [Independent tags with GL codes](https://help.expensify.com/assets/Files/Independent+with+GL+codes+format.csv) +- [Independent tags without GL codes](https://help.expensify.com/assets/Files/Independent+without+GL+codes+format.csv) + +**Notes:** + - Only CSV and TSV files are supported for multi-level tag imports. A single file can include up to 50,000 tags. + +--- + +## How single-level Tags and multi-level Tags affect tag fields on expenses + +Single-level Tags and multi-level Tags determine how many tag fields appear on each expense. This directly controls how many “layers” of coding members must complete when submitting expenses. + +**Single-level tags:** +- Members see one Tag field on expenses. +- They select one value from a single list (for example: Marketing, Sales, IT). +- Best when you only need one layer of coding. + +Example: If you use single-level Tags for Department, members will see one field labeled **Tag** and choose one department. + +**Multi-level tags** + +- Members see **multiple Tag fields** (one for each level you configure). +- Each level appears as its own field on the expense. +- Best when you need multiple layers of coding (for example: Department and Location). + +**Note:** +- With single-level Tags, you can edit or delete individual tags directly in the workspace. +- With multi-level Tags, you must update and re-import your spreadsheet to make changes. + +--- + +## How dependent and independent multi-level Tags work + +When using multi-level Tags, you must choose whether the tag levels are **dependent** or **independent**. This determines whether selecting one tag filters the available options in the next level. + +**Dependent Tags** + +- Lower-level tag options depend on the selection made in the level above. +- When a member selects a value in Level 1, the options in Level 2 (and Level 3, etc.) are filtered to only the valid combinations from your spreadsheet. +- Best when only specific tag combinations are allowed. + +Example: + +If Level 1 is **State** and Level 2 is **City**, selecting `California` in Level 1 would limit Level 2 options to: +- San Francisco +- San Diego +- Los Angeles + +Members would not see cities that don’t belong to California. + +**Independent Tags** + +- Each tag level is its own separate list. +- Selecting a tag in one level does not filter the available options in other levels. +- Best when all combinations across levels are allowed. + +Example: + +If Level 1 is **Department** and Level 2 is **Location**, members can choose any department with any location. + +When importing multi-level Tags, enable **These are independent tags** to import the levels as independent. If this option is disabled, the Tags will be imported as dependent. + +--- + +## How to delete expense tags + +1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]**. +2. Select **Tags**. +3. Select one or more tags. +4. Choose **Selected** in the top right. +5. Select **Delete tag**. + +**Note:** For multi-level tags, individual tags can’t be deleted manually. Upload a new spreadsheet without the tags you want removed. + +--- + +## How to add or edit a tag GL code + +Workspaces on the Control plan can assign a GL code to each tag for exporting purposes. Tag GL codes are not visible to members. + +1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]**. +2. Select **Tags**. +3. Select a tag to open its detail panel. +4. Select the **GL Code** field, enter or update the code, then select **Save**. + +--- + +## How Expensify suggests Tags automatically + +Expensify may suggest Tags based on how similar expenses were coded previously. + +**Note:** Manually applied tags are not overwritten automatically. Suggestions may vary by member and by merchant. + +--- + +# FAQ + +## Can I edit expense tags on a submitted expense report? + +Yes. You can edit tags until the expense is approved or reimbursed. + +Approvers can also edit tags after approval by taking control of the report. + +## Can I see an audit trail of tag changes? + +Yes. When a tag is changed manually, the update appears in the expense chat. + +## What happens if a tag is disabled in my accounting system? + +It will be removed from the workspace’s tag list. However, it will still appear on expenses or reports where it was previously applied. + +## Why can’t I enable multi-level tags? + +Multi-level tags are available on Control workspaces only. If your Control workspace is connected to an accounting integration, you will need to manage tags in your accounting system and sync them into Expensify. + +## Can members see Tag GL codes? + +No. Tag GL codes are visible only to Workspace Admins. If members need that information, include the GL code in the tag name (for example: `1001 - Marketing`). diff --git a/docs/articles/new-expensify/workspaces/Create-expense-tags.md b/docs/articles/new-expensify/workspaces/Create-expense-tags.md deleted file mode 100644 index 37edeafb488b..000000000000 --- a/docs/articles/new-expensify/workspaces/Create-expense-tags.md +++ /dev/null @@ -1,170 +0,0 @@ ---- -title: Create Expense Tags -description: Add tags to use for coding expenses. -keywords: [New Expensify, expense tags, class tracking, cost center, import tags, coding expenses, tag GL code] -internalScope: Audience is Workspace Admins. Covers enabling, creating, importing, activating, and managing expense tags, including multi-level tags and tag GL codes. Does not cover personal expense rules or accounting system configuration. ---- - -In Expensify, **tags** represent attributes like classes, projects, cost centers, locations, customers, or jobs. They help code expenses for accounting and reporting. - -Workspace Admins can create tags manually, import them from a spreadsheet, or sync them from an accounting system like QuickBooks Online, Intacct, Xero, or NetSuite. Once created, tags can be enabled or disabled as needed. Over time, Expensify also learns your tag preferences and applies them automatically. - -The Tags table displays the tag **Name**, **GL Code** (if assigned), and whether it's **Required** for expenses. - -![The Tags tab]({{site.url}}/assets/images/NewExpensify_ManageTags_3.png){:width="100%"} - ---- - -# How to enable expense tags - -Before you can manage tags, you need to enable the **Tags** feature for your workspace. - -1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**. -2. Select your **workspace name**. -3. Select **More Features**. -4. In the **Organize** section, toggle **Tags** on. - ---- - -# How to add expense Tags - -## Manually Add A Single Tag - -1. Go to **Workspaces > [Workspace Name] > Tags**. -2. Click **Add Tag** at the top of the page. -3. Enter a name and click **Save**. - -## Import A Single Level Of Tags From A Spreadsheet - -1. Go to **Workspaces > [Workspace Name] > Tags**. -2. Click **More > Import spreadsheet** (or if you haven't added any tags yet, just click **Import** from the main Tags settings page). -3. Click **Single level of tags**. -4. Click **Choose File** and select the file to import. -5. Toggle the "File contains column headers" on or off accordingly, then select which spreadsheet column should be mapped to which tag field. We require columns Name and Enabled, and you can optionally include a column for Tag GL Code. GL codes will be visible to Workspace Admins in the Tags table. -6. Click **Import** to finish importing the tags. - -1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**. -2. Select your **workspace name**. -3. Select **Tags**. -4. Click **Add Tag**. -5. Enter a name and click **Save**. - -## How to import a single level of expense tags using a spreadsheet - -1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**. -2. Select your **workspace name**. -3. Select **Tags**. -4. Click **More > Import spreadsheet** - - If no tags exist yet, select Import from the Tags page. -5. Select **Single level of tags**. -6. Click **Choose File** and upload your spreadsheet. -7. Map the required columns: - - Name - - Enabled - - (Optional) Tag GL Code -8. Select **Import**. - -## How to import multi-level expense tags using a spreadsheet - -1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**. -2. Select your **workspace name**. -3. Select **Tags**. -4. Click **More > Import spreadsheet** - - If no tags exist yet, select Import from the Tags page. -5. Select **Multi-level tags**. -6. Click **Choose File** and upload your spreadsheet. -7. Configure the import options: - - Whether the first row contains tag level names - - Whether tag levels are dependent or independent - - Whether each level includes a GL code column -8. Select **Import**. - -You can use one of these template files to build your tags list: - -- [Dependent tags with GL codes](https://help.expensify.com/assets/Files/Dependent+with+GL+codes+format.csv) -- [Dependent tags without GL codes](https://help.expensify.com/assets/Files/Dependent+without+GL+codes+format.csv) -- [Independent tags with GL codes](https://help.expensify.com/assets/Files/Independent+with+GL+codes+format.csv) -- [Independent tags without GL codes](https://help.expensify.com/assets/Files/Independent+without+GL+codes+format.csv) - -**Notes:** - - Only CSV and TSV files are supported for multi-level tag imports. - - A single file can include up to 50,000 tags. - - Each import replaces the existing tag list. Update and re-upload the original file to preserve tags. - -## How to delete expense tags - -1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**. -2. Select your **workspace name**. -3. Select **Tags**. -4. Select one or more tags. -5. Click **Selected** in the top right corner. -6. Click **Delete Tag**. - -**Note:** For multi-level tags, individual tags can’t be deleted manually. To remove them, upload a new spreadsheet without the tags you no longer need. For single-level tags, individual tags can be deleted manually - ---- - -## How to enable or disable expense tags - -Workspace Admins can turn tags on or off at any time to control which options are available to members. - -1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**. -2. Select your **workspace name**. -3. Select **Tags**. -4. Use the toggle to enable or disable the tag. - -**Note:** Tags imported from an accounting system are added as **inactive** by default and must be enabled on manually. - ---- - -## How to add or edit a tag GL code - -Workspaces on the Control plan can assign a GL code to each tag for exporting purposes. Tag GL codes are not visible to members. - -1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), click **Workspaces**. -2. Select your **workspace name**. -3. Select **Tags**. -4. Click a tag to open its detail panel. -5. Click the **GL Code** field, enter or update the code, then click **Save**. - ---- - -# How to apply expense tags automatically - -Expensify provides two ways to apply tags automatically based on merchant behavior. - -## Learned Tag Suggestions - -Expensify learns how tags are applied over time and suggests them automatically. - -- Manual corrections are remembered over time to improve future suggestions. -- Tags that were manually applied to expenses aren’t overwritten automatically. -- These suggestions are based on patterns and may vary by user. - ---- - -# FAQ - -## Can I edit expense tags on a submitted expense report? - -Yes. You can edit tags until the expense is approved or reimbursed. - -Approvers can also edit tags, even post-approval, by taking control of the report. - -## Can I see an audit trail of tag changes? - -Yes. When a tag is manually changed, the update is logged in the associated expense chat. - -## What happens if a tag is disabled in my accounting system? - -It will be removed from the workspace’s tag list. However, it will still appear on any expenses or reports where it was already applied. - -## Why can’t I enable multi-level tags? - -If you are connected to an accounting integration, you will not see this feature. You will need to add those tags in your accounting system first, then sync the connection. - -## How can my Employees see the GL Codes? - -GL codes are visible to Workspace Admins in the Tags table but are not visible to workspace members. If you need members to see GL codes, consider including the GL code in the tag -name itself. - From ebccaff179c2365cee0deae4e393fac3e110eacb Mon Sep 17 00:00:00 2001 From: Stephanie Elliott <31225194+stephanieelliott@users.noreply.github.com> Date: Fri, 6 Mar 2026 16:58:11 -1000 Subject: [PATCH 2/2] Update redirects.csv update redirects file --- docs/redirects.csv | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/redirects.csv b/docs/redirects.csv index 0ccb792b38cc..c9ce440f60c8 100644 --- a/docs/redirects.csv +++ b/docs/redirects.csv @@ -906,3 +906,4 @@ https://help.expensify.com/articles/expensify-classic/connections/Zenefits,https https://help.expensify.com/articles/expensify-classic/connections/TriNet-Integration,https://help.expensify.com/articles/expensify-classic/connections/TriNet https://help.expensify.com/unlisted/avoiding-duplicates,https://help.expensify.com/expensify-classic/hubs/expenses/How-to-prevent-duplicate-expenses https://help.expensify.com/articles/new-expensify/settings/title:%20Personal-Expense-Rules,https://help.expensify.com/articles/new-expensify/settings/Personal-Expense-Rules +https://help.expensify.com/articles/new-expensify/workspaces/Create-expense-tags,https://help.expensify.com/articles/new-expensify/workspaces/Create-and-manage-expense-tags