Skip to content

[No QA] [HOLD on image] Update docs to reflect GL Code column in Categories and Tags tables#81468

Open
stephanieelliott wants to merge 4 commits intomainfrom
helpsite-add-GL-to-category-table
Open

[No QA] [HOLD on image] Update docs to reflect GL Code column in Categories and Tags tables#81468
stephanieelliott wants to merge 4 commits intomainfrom
helpsite-add-GL-to-category-table

Conversation

@stephanieelliott
Copy link
Contributor

Added documentation for the new GL Code column that now appears in the Categories and Tags table views for Workspace Admins.

  • Updated Create-expense-categories.md to clarify GL codes are visible in table

  • Updated Create-expense-tags.md to mention GL Code column visibility

Related Design request for images: https://github.com/Expensify/Expensify/issues/597217

stephanieelliott and others added 4 commits February 4, 2026 17:51
Added documentation for the new GL Code column that now appears in the Categories and Tags table views for Workspace Admins.

- Updated Create-expense-categories.md to clarify GL codes are visible in table

- Updated Create-expense-tags.md to mention GL Code column visibility

- Updated Require-tags-and-categories-for-expenses.md with table column info

- Updated Workspace-Rules.md to include GL Code in table descriptions

Co-authored-by: Cursor <cursoragent@cursor.com>

Admins can manually create categories for a workspace, or they can be imported automatically when connected to an accounting platform like QuickBooks, Xero, NetSuite, or Intacct. Once imported, categories can be enabled or disabled as needed. Over time, Expensify also learns how you apply categories to specific merchants and suggests them automatically.

The Categories table displays the category **Name**, **GL Code** (if assigned), and whether it's **Enabled** for workspace members to use.
Copy link
Contributor

Choose a reason for hiding this comment

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

AI Readiness violation: This new line was added before the H1 heading and image reference, but there's no breadcrumb path below the H1. According to HelpDot standards, articles should include a breadcrumb path (like "Settings > Workspaces > Categories") immediately after the H1 heading to help with AI navigation and context.

## How Can My Employees See the GL Codes?

GL codes are not visible to employees by default. If visibility is required, consider including the GL code in the category name itself.
GL codes are visible to Workspace Admins in the Categories table but are not visible to workspace members. If you need members to see GL codes, consider including the GL code in the category name itself.
Copy link
Contributor

Choose a reason for hiding this comment

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

Terminology violation: Use "workspace members" instead of "employees" to match Expensify standards. The updated line 141 correctly uses "workspace members," but this FAQ question heading still uses the outdated term "Employees."


Admins can manually create one level of tags or multiple levels of tags for a workspace, or they can be imported automatically if your workspace is connected to an accounting system like QuickBooks Online, Intacct, Xero, or NetSuite. Once added, tags can be enabled or disabled. Expensify also learns your tag preferences for merchants and applies them automatically.

The Tags table displays the tag **Name**, **GL Code** (if assigned), and whether it's **Required** for expenses.
Copy link
Contributor

Choose a reason for hiding this comment

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

AI Readiness violation: Missing breadcrumb path below the H1 heading. According to HelpDot standards, articles should include a breadcrumb path (like "Settings > Workspaces > Tags") immediately after the H1 heading to help with AI navigation and context.

# Configure Tag Rules

Tag Rules allow tagging-based workflows and approvals.
Tag Rules allow tagging-based workflows and approvals.
Copy link
Contributor

Choose a reason for hiding this comment

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

Formatting violation: Trailing whitespace detected at the end of this line. Please remove the trailing space after "approvals." to maintain clean formatting.

@github-actions
Copy link
Contributor

github-actions bot commented Feb 5, 2026

HelpDot Documentation Review

Overall Assessment

This PR adds documentation for the new GL Code column visibility in the Categories and Tags table views for Workspace Admins. The changes are straightforward and well-targeted, updating three documentation files to clarify that GL codes are now visible to admins in table views. The updates are contextually appropriate and improve user understanding of the feature.

Scores Summary

  • Readability: 9/10 - The writing is clear, concise, and maintains excellent flow. The additions integrate seamlessly with existing content and use appropriate language for the target audience.
  • AI Readiness: 8/10 - Good context and structure. The changes maintain proper heading hierarchy and add descriptive content. Minor opportunity to enhance searchability with more explicit feature descriptions.
  • Style Compliance: 9/10 - Excellent adherence to Expensify style guidelines. Proper use of terminology ("Workspace Admins," "workspace members"), consistent formatting, and appropriate voice.

Key Findings

Strengths:

  • Clear distinction between "Workspace Admins" (who can see GL codes) and "workspace members" (who cannot)
  • Consistent messaging across both Categories and Tags documentation
  • Updates placed in logical locations within the document flow
  • Maintains the existing helpful suggestion for workaround (including GL codes in names if member visibility is needed)
  • New table description adds helpful context at the beginning of both documents

Minor Issues:

  • Workspace-Rules.md: The change appears to be whitespace-only (trailing space added to line 102), which adds no value
  • Slight redundancy: The phrase "GL codes are visible to Workspace Admins in the Tags table" appears twice in Create-expense-tags.md (lines 42 and 119 in the updated version), though in slightly different contexts

Opportunities for Enhancement:

  • Consider adding a screenshot callout specifically highlighting the GL Code column in the table view (though the PR notes this is on hold pending design)
  • The FAQ answer in Create-expense-categories.md could potentially reference the new table view more explicitly

Recommendations

Required Actions:

  1. Remove the whitespace-only change in Workspace-Rules.md - This appears to be an accidental edit and should be reverted

Optional Improvements:

  1. Consider whether the repeated mention of GL code visibility in the Tags import section (line 42) and the GL code editing section (line 119) is intentional or could be streamlined
  2. When images become available, ensure the new GL Code column is clearly visible in screenshots to reinforce the text descriptions

Positive Elements to Maintain:

  • The parallel structure between Categories and Tags documentation
  • The clear distinction between admin and member visibility
  • The practical workaround suggestion for member visibility needs

Files Reviewed

  • Create-expense-categories.md: Good additions. New table description is helpful, and the FAQ update provides important clarification about admin-only visibility.
  • Create-expense-tags.md: Solid updates throughout. Multiple touchpoints reinforce the GL code visibility feature appropriately.
  • Workspace-Rules.md: Whitespace-only change that should be removed.

Conclusion

This is a high-quality documentation update that successfully communicates the new GL Code column visibility feature. With the removal of the unnecessary whitespace change in Workspace-Rules.md, this PR will be ready for approval. The writing is clear, consistent, and follows Expensify standards effectively.

Overall Score: 8.7/10


Detailed line-by-line feedback has been provided as inline comments where applicable.

@github-actions github-actions bot changed the title [HOLD on image] Update docs to reflect GL Code column in Categories and Tags tables [No QA] [HOLD on image] Update docs to reflect GL Code column in Categories and Tags tables Feb 5, 2026
@OSBotify
Copy link
Contributor

OSBotify commented Feb 5, 2026

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants