Invoice Labels (Tags): Color-Code & Filter Your Invoices

Invoice Labels (Tags): Color-Code & Filter Your Invoices

Invoice labels (also known as tags) are color-coded identifiers you can apply to invoices to organize internal workflows—without changing the invoice’s official status (e.g., Draft / Unpaid / Paid / Void).

Invoice labels workflow: create, assign, view/filter, manage

Use labels to quickly flag invoices that need attention (for example: To Review, Disputed, Manual Payment Required, VIP, Insurance). Once applied, you can filter and segment your invoice list by label for faster follow-ups.

Table of contents


Why use invoice labels?

  • Instant visibility: spot invoices needing action at a glance (e.g., “To Review”, “Disputed”).
  • Faster filtering: pull up targeted invoice groups without spreadsheets or long notes.
  • Consistent internal workflow: everyone uses the same tags across finance and operations.
  • Better follow-up: segment invoices for collections, approvals, audits, or special handling.

Note: Labels are for internal organization. They don’t automatically change invoice status or customer notifications unless you intentionally use them in your workflow.


Prerequisites & permissions

  • To apply labels to invoices: you need access to the Invoices module and permission to edit/manage invoices (permission names can vary by role setup).
  • To create, edit, or delete labels: you typically need admin/settings access to Settings > General Settings > Labels.

Important: Labels are shared across OctopusPro. Renaming or deleting a label affects everywhere that label is used (invoices, bookings, quotes, inquiries, customers, etc.).


Where labels appear

  • Invoices list: labels show as colored tags on the invoice row, making priority invoices easy to spot.
  • Invoice details: you can add/remove labels from the invoice’s Actions menu.
  • Filters: the invoice filter panel lets you filter by labels using AND/OR logic and also exclude labels.

Create labels from Settings (recommended)

Create and standardize your label library first—especially if multiple team members will use the same naming conventions.

  1. Go to Settings > General Settings > Labels.
  2. Click New Label.
  3. Enter a clear label name (e.g., “To Review”, “Manual Payment”, “Disputed”).
  4. Choose a color.
  5. Click Save.

Create a new label from Settings > General Settings > Labels


Add a label from the invoices list (All Invoices)

This is the quickest method when you’re working through your invoice list.

  1. Go to Invoices > All Invoices.
  2. Find the invoice you want to tag, then click Actions.
  3. Select Add Label.
  4. In the popup, search and tick one or more labels.
  5. Click Apply.

Add label from invoice actions menu in the invoices list

Tip: If you don’t see the label you need, click Create New Label in the popup, name it, choose a color, then save and apply it immediately.


Add a label from the invoice details page

Use this method when you’re already reviewing an invoice and want to tag it without returning to the list.

  1. Open the invoice.
  2. Click Actions.
  3. Select Add Label.
  4. Select your label(s), then click Apply.

Add label from invoice details page actions menu


Bulk label multiple invoices (batch update)

If you need to apply the same label to many invoices (e.g., “End of Month Review”), use bulk selection.

  1. Go to Invoices > All Invoices.
  2. Select multiple invoices using the checkboxes.
  3. Click Actions (bulk actions).
  4. Select Add Label, choose your label(s), then click Apply.

Apply multiple labels to a single invoice

You can add multiple labels to reflect different internal categories at the same time (e.g., “VIP” + “Manual Payment” + “To Review”).

  1. Open the invoice (or use the invoice list Actions menu).
  2. Click Add Label.
  3. Select multiple labels in the list.
  4. Click Apply.

Invoice labels popup showing multiple labels selected and Apply button


Use nested labels (parent/child) for invoice workflows

Nested labels let you build a hierarchy (similar to Gmail labels). This keeps large label libraries organized and easier to scan.

Example hierarchy:

  • Finance
    • To Review
    • Disputed
    • Manual Payment
  • Customer Type
    • VIP
    • Wholesale

To create nested labels:

  1. Go to Settings > General Settings > Labels.
  2. Click New Label.
  3. Enter the label name and choose a color.
  4. Select a Parent Label (if available) to nest it under a category.
  5. Click Save.

Filter invoices by labels (AND/OR logic)

Filter your invoice list to show only invoices that match selected labels.

  1. Go to Invoices > All Invoices.
  2. Click the Filter icon.

Filter icon on the invoices list

  1. In the filter popup, open the Label field and select one or more labels.
  2. OR logic (default): shows invoices that match any selected label.
  3. AND logic: toggle Match all selected labels ON to show invoices that match all selected labels.
  4. Click Filter to apply.

Filter invoices popup showing label selection and Match all selected labels toggle


Exclude invoices with specific labels

Use this when you want to hide invoices that contain certain labels (e.g., exclude “Resolved”, “Paid Manually”, or “No Action Needed”).

  1. Open Invoices > All Invoices and click Filter.
  2. Select the label(s) you want to exclude.
  3. Toggle Exclude selected labels ON.
  4. Click Filter.

Exclude selected labels toggle in the invoice filters popup


Remove (de-assign) labels from an invoice

To remove a label from a single invoice, open the invoice’s labels popup, untick the label(s), then apply the update.

  1. Open the invoice (or use Actions > Add Label from the list).
  2. Untick the label(s) you want to remove.
  3. Click Apply.

Edit or delete labels (global label library)

Edit (rename or change color)
  1. Go to Settings > General Settings > Labels.
  2. Find the label (or use search).
  3. Click the label name (or Edit).
  4. Update the label name and/or color, then click Save.

Edit label option in Settings > Labels

Delete (remove from all records)

Important: Deleting a label removes it from your system and from any records it was applied to. If you still need it for historical reporting, consider renaming it instead of deleting.

  1. Go to Settings > General Settings > Labels.
  2. Select one or more labels using the checkbox.
  3. Click Delete to remove them.

Delete label option from Settings > Labels


Best practices

  • Use labels for internal workflow (review states, exceptions, customer type), not as a replacement for invoice statuses.
  • Keep names short and consistent so they display neatly in list views.
  • Standardize colors (e.g., red = urgent, yellow = review, green = cleared).
  • Use parent labels if your label list grows (Finance, Customer Type, Internal Stage).
  • Avoid duplicates (e.g., don’t create “To Review” and “Review Needed” unless they mean different things).

Troubleshooting

I can’t see “Add Label”.
This is usually permission-related. Confirm your role has access to invoices and invoice editing/management permissions, and that you’re viewing an invoice screen where Actions are available.

I created a label but can’t find it in the picker.
Use the search bar in the label picker. Labels are commonly listed alphabetically, and nested labels may appear under their parent.

I renamed a label and it changed in other places.
That’s expected—labels are shared across modules. Renaming updates the label everywhere it’s used.


FAQ

Can I label multiple invoices at once?
Yes. Select multiple invoices from Invoices > All Invoices, then use Actions > Add Label.

What’s the difference between invoice labels and invoice statuses?
Status represents the invoice lifecycle (e.g., Draft, Unpaid, Paid, Void). Labels are flexible internal tags (e.g., “Disputed”, “Manual Payment”, “To Review”) used for categorization and filtering.

Will customers see invoice labels?
Labels are designed for internal use in the admin workflow.


To stay updated, please subscribe to our YouTube channel.

Scroll to top