Skip to content

Tags

Tags provide a flexible, cross-cutting labeling system for transactions. While categories provide a single hierarchical classification, tags allow you to add multiple labels to any transaction.

Why Tags?

Categories are great for answering "what type of expense is this?" but sometimes you need additional dimensions. Tags answer questions like:

  • Project-based: Tag transactions related to a specific project (e.g., "Home Renovation", "Vacation 2025")
  • Status-based: Mark transactions as "Reimbursable" or "Tax Deductible"
  • Recurring: Tag regular expenses like "Subscription" or "Monthly"
  • Shared: Mark expenses that are "Split with Partner"

A single transaction can have multiple tags, and a single tag can be applied to many transactions (many-to-many relationship).

Tag Properties

PropertyDescription
NameDisplay name of the tag
DescriptionOptional description of what the tag represents
ColorOptional color for visual identification

Scope

Like all entities in Financer, tags belong to a household. Each household has its own independent set of tags.

Tags vs. Categories

AspectCategoriesTags
Per transactionOne categoryMultiple tags
StructureHierarchical (parent/child)Flat
Budget trackingYesNo
Type-restrictedYes (Income or Expense)No
Best forPrimary classificationCross-cutting concerns

Use categories for your primary financial classification and tags for any additional dimensions you want to track.

Released under the BSD 3-Clause License.