Skip to content
Merged
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,198 @@
---

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Add redirect for renamed tags article URL

Renaming this markdown file changes the published article path because our docs route generator derives href directly from the filename (.github/scripts/createDocsRoutes.ts), but this commit does not add a redirect from .../Create-expense-tags to the new slug. We still have multiple links pointing at the old URL (for example in src/CONST/index.ts and src/components/SidePanel/HelpContent/helpContentMap.tsx), so those links will start returning 404 after this deploy unless docs/redirects.csv is updated.

Useful? React with 👍 / 👎.

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

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 capitalization inconsistency: "tag" is lowercase here, but other headings capitalize "Tags" (e.g., "How to enable Tags on a workspace", "How to import single-level Tags"). Choose one convention and apply it to all headings throughout the article.

Suggested change
## How to create a tag manually
## 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]**

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.

Formatting inconsistency: "navigation tabs" is not bold here, but it is bold in other sections (lines 28, 155, 164, 172). For consistency, wrap it in bold: **navigation tabs**. Also, this step is missing a period at the end.

Suggested change
1. In the navigation tabs (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]**
1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]**.

2. Select **Tags**.

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.

Formatting inconsistency: Missing period at end of step.

Suggested change
2. Select **Tags**.
2. Select **Tags**.

3. Choose **Add tag**

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.

Formatting inconsistency: This step is missing a period at the end. Also, "Choose" is used here but "Select" is used in parallel steps elsewhere in the article. Pick one verb and use it consistently throughout.

Suggested change
3. Choose **Add tag**
3. Select **Add tag**.

4. Enter a tag name and select **Save**.

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.

Style compliance: Per Expensify HelpDot standards, end-of-flow confirmation buttons should use "Confirm" rather than "Save." If the UI button literally reads "Save," please disregard this comment -- but if the button text is actually "Confirm," this should be updated.

Same concern applies to line 175.


---

## 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).

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.

Formatting inconsistency: "navigation tabs" is not bold here but is bold in other sections. Also missing a period at the end of this step.

Suggested change
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]**.


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.

Formatting inconsistency: Missing period at end of step.

Suggested change
2. Select **Tags**.

1. In the navigation tabs (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]**

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.

Formatting inconsistency: Missing period at end of step.

Suggested change
1. In the navigation tabs (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]**
3. Select **More** > **Import spreadsheet**.

2. Select **Tags**.
3. Select **More** > **Import spreadsheet**

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.

Verb inconsistency: "Choose" is used here, but most other steps in the article use "Select". For consistency, use "Select" throughout.

Suggested change
3. Select **More** > **Import spreadsheet**
4. Select **Single level of tags**.

- 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

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.

Formatting inconsistency: "navigation tabs" is not bold here but is bold in other sections (e.g., lines 28, 155, 164). For consistency, use **navigation tabs**.

Suggested change
1. In the **navigation tabs** (on the left on web, and at the bottom on mobile), select **Workspaces** > **[workspace name]**.

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**.

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.

Verb inconsistency: "Choose" is used here, but most other steps in the article use "Select". For consistency, use "Select" throughout.

Suggested change
3. Select **More** > **Import spreadsheet**.
4. Select **Multi-level tags**.

- 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)

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.

Formatting inconsistency: "Notes:" (plural) is used here but only one bullet point follows. The rest of the article uses "Note:" (singular) for single-item notes. Use the singular form for consistency.

Suggested change
- [Independent tags without GL codes](https://help.expensify.com/assets/Files/Independent+without+GL+codes+format.csv)
**Note:**


**Notes:**
- Only CSV and TSV files are supported for multi-level tag imports. A single file can include up to 50,000 tags.

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.

Readability / AI Readiness: This heading is long and hard to scan. Consider shortening it while keeping the full feature name. For example:

Suggested change
## How single-level and multi-level Tags affect expenses

---

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.

Readability: The phrase "how many 'layers' of coding members must complete" is awkward and could be misread (it is unclear whether "coding members" is a noun phrase or "coding" modifies "layers"). Consider rephrasing for clarity:

Suggested change
Single-level Tags and multi-level Tags determine how many tag fields appear on each expense. This controls how many layers of coding a member must complete when submitting expenses.

## 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**.

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 capitalization inconsistency: "tags" is lowercase here, but other section headings capitalize "Tags" (e.g., "How to enable Tags on a workspace", "How to import single-level Tags"). For consistency:

Suggested change
## How to delete expense Tags

**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

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.

Verb inconsistency: "Choose" is used here, but most other steps in the article use "Select". For consistency, use "Select" throughout.

Suggested change
## How to add or edit a tag GL code
4. Select **Selected** in the top right.


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**.

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 capitalization inconsistency: "tag" is lowercase here but capitalized ("Tags") in most other headings. For consistency:

Suggested change
2. Select **Tags**.
## How to add or edit a Tag GL code

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.

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.

AI Readiness: "It" at the start of this answer is a vague reference. For better clarity and AI retrieval, restate the subject.

Suggested change
It will be removed from the workspaces tag list. However, it will still appear on expenses or reports where it was previously applied.
The disabled tag 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`).
170 changes: 0 additions & 170 deletions docs/articles/new-expensify/workspaces/Create-expense-tags.md

This file was deleted.

1 change: 1 addition & 0 deletions docs/redirects.csv
Original file line number Diff line number Diff line change
Expand Up @@ -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
Loading