Tags are customizable labels in integrator.io that you can apply to flow errors to categorize, prioritize, and track resolution progress. Use tags to provide context—such as status levels or priority rankings—to help your team collaborate more effectively during troubleshooting. Managing flow errors effectively requires a coordinated approach between monitoring, organization, and delegation. After you investigate and resolve flow errors to identify the root cause, use tagging to route specific issues to the right team members. By combining tagging with the ability to assign errors to users, you create a searchable, prioritized backlog that ensures critical blockers are addressed first. To get started, ensure your team has the correct setup by following the guide to manage integration users and permissions, which defines who can view, apply, and manage these labels.
Before you start tagging errors, verify the following requirements:
-
Subscription plan: Standard, Professional, or Enterprise edition.
-
Permissions: Any user with
Admin,Manage,Monitor, orCustomaccess can create, rename, delete, apply, or remove tags. -
Access: Tags are available for both Open errors and Resolved errors. For open errors, you must use the unified error view.
The platform uses the following rules to maintain consistency across your account:
|
Rule |
Specification |
|---|---|
|
Account limit |
Maximum of 1,000 unique tags per account. |
|
Error limit |
Maximum of three tags per single error. |
|
Character limit |
Maximum of 100 characters per tag. |
|
Case sensitivity |
Tag names are case-insensitive (e.g., "URGENT" and "urgent" are duplicates). |
|
Global vs. Local |
Creating/editing/deleting a tag has a globa. Applying/removing a tag affects only that error. |
You can create tags as you encounter errors (ad hoc) or build a predefined list (planned) for your team to follow.
To update several errors at once, use the batch tagging feature:
-
In the error list, select the checkbox for each error you want to modify.
-
Select the Tag icon at the top of the list.
-
To apply tags, select the checkboxes and specifiy any new/existing labels – these labels you provide will overridde the exisiting labels/tags.
-
Select Apply.
In bulk tagging, it uniformly applies the tags
The platform automatically applies tags to recurring errors based on specific identifiers to save manual effort.
Errors with a retry data key
|
Scenario |
Result |
|---|---|
|
Apply tag to open error |
The tag is automatically applied to other open errors with the same |
|
Retry a tagged error |
If the retry fails, the same tag is automatically applied to the new open error. |
|
Resolve a tagged error |
The resolved error record retains all applied tags for historical tracking. |
Errors with a trace key (no retry data key)
Tags are account-wide, and any changes update every error using that tag (label) across all integrations.
-
Rename a tag: Select the Tag icon, select the tag name, enter the new name, and select outside the box to save.
-
Delete a tag: Select the Tag (trash) icon next to the tag and select Delete to confirm.
This action renames or deletes the tag for all associated errors in the account.
Filters use "OR" logic. If you select multiple tags, the results show errors that contain at least one of those tags.
-
Select the Filter icon at the top of the error list.
-
Select the checkbox for the tags you want to see (for example,
P1: Urgent). -
Select Apply.
To reset the view, select the Filter icon and select Clear filter.