The Tag maintenance feature helps you identify and manage broken and unused tags, and standardize tag names, so you can improve the accuracy and relevance of your data.
Access and requirements
Any user who has permission to create, edit, or manage tags can access Tag maintenance from either Product > Pages or Product > Features in the left-side menu, then following the link at the top of the page.
Feature functionality
Tag maintenance includes an Overview tab that summarizes the overall health of your tags and an AI Name Suggester tab that suggests tag names based on your naming conventions. You can filter by apps, timeframe, tag type, and impact level.
Key definitions include:
- Tag health score. The percentage of total tags that are neither broken nor unused.
- Broken tags. Feature and page tags that are automatically flagged when they haven't collected data according to their typical usage pattern. Pendo calculates each tag's threshold using data from the past six months and includes a safety margin to avoid false flags. Tags without historical data are flagged when they haven't collected data for three consecutive days.
- Unused tags. Feature and page tags that are collecting data but aren't currently used in guides, segments, or reports. These might have been created for testing or one-off projects.
Tip: Aim to maintain a high tag health percentage and low percentages of broken and unused tags.
Review broken tags
The Broken tags table lists up to 500 tags at a time that are automatically flagged when they haven't collected data according to their typical usage pattern. For each tag, you can review key details such as:
- Type. Indicates whether it’s a Page or Feature tag.
- Broken tag definition, which shows the tag's threshold - the number of days without data before it's flagged as broken. This is calculated using the tag's historical data and includes a safety margin.
- Last received event. The number of days since the tag received data.
-
Impact level. Based on associated guides:
- High. A broken tag associated with at least one public guide.
- Medium. A broken tag associated with at least one non-public guide.
- Low. A broken tag that's not associated with any public or non-public guides.
- Include rules. Define what URL patterns or elements the tag captures. You can expand and collapse this column to view all rules associated with the tag.
- Associated guides, reports, and segments.
Take action
The impact levels help you prioritize which tags to investigate or remove. To view available actions, hover over a tag's row and select Actions. Choose from the following options:
- Edit tag. Selecting edit tag will take you to the relevant details page of the page or feature, where you can make changes. Read more on View and manage tagged Features.
- Delete tag. You can delete a tag if it has no dependencies.
- Exclude tag. Removes the tag from the table and recalculates the Tag health score. Excluding a tag doesn't delete it or remove its historical data. For more information, see Exclude and include tags.
You can also take action on multiple tags at once. For more information, see Bulk actions.
Review unused tags
The Unused tags table lists up to 500 tags at a time that are collecting data but aren't in use. For each tag, you can review its details, including an Include rules column that shows the URL patterns or elements the tag captures. You can expand and collapse this column to view all rules. Decide whether to keep, edit, delete, exclude the tag and create a guide or report.
Take action
Use this view to reduce clutter from tags that may have been created for temporary or test purposes. To view available actions, hover over a tag's row and select Actions. Choose from the following options:
- Create guide. Selecting create guide will take you to the guide list where you can create a new guide or edit an existing guide to target your tag.
- Create report. Selecting create report will take you to the reports list where you can create a new report or edit an existing report to query your tag.
- Edit tag. Selecting edit tag will take you to the relevant details page of the page or feature, where you can make changes. Read more on View and manage tagged Features.
- Delete tag. You can delete a tag if it has no dependencies.
- Exclude tag. Removes the tag from the table and recalculates the Tag health score. Excluding a tag doesn't delete it or remove its historical data. For more information, see Exclude and include tags.
You can also take action on multiple tags at once. For more information, see Bulk actions.
Review AI name suggestions
The AI Name Suggester identifies tag names that don't follow your naming conventions and suggests corrections. This helps maintain consistency across your tags and makes them easier to find and understand. The AI Name Suggester is available for web and extension apps only.
To view AI naming suggestions, turn on AI Tag Name Suggester in your subscription settings. If you add Tag Naming Conventions in your application settings, Pendo AI suggests corrections based on the conventions you provide. If no naming conventions are added, suggestions are based on Pendo best practices. Pendo AI scans your tag names once every 24 hours.
Note: After you first enable the feature, it can take up to 24 hours for initial suggestions to appear.
The AI Name Suggester tab lists tags that don't match your app's naming conventions. For each tag, you can review the Current name and the Suggested name. Decide whether to accept or reject the suggestions.
A banner also appears at the top of the Pages and Features list pages showing the number of naming convention issues. Select Review to go to the AI Name Suggester tab in Tag maintenance.
Tag naming convention examples
To help you get most out of the AI Tag Name Suggester, you can use the following naming convention prompts as a starting point. Copy and paste them directly in the Tag Naming Conventions field or modify them to fit your team’s workflow:
-
Product area first (best for large apps). Groups every tag by its functional area, making it easy to filter and search in the Features and Pages lists.
Prompt:
"All names must start with the product area in brackets, followed by the page name, and then the specific element. Use the format: [Product Area] | Page Name | Element Name. Example: [Analytics] | Dashboard | Export Button."
-
Action-oriented (best for tracking UX outcomes). Focuses on what the user is doing, which is helpful for non-technical stakeholders viewing reports.
Prompt:
"Name tags based on the user action. Start with a category, then the page, then the action in past tense. Use title case and underscores for spaces. Format: Category - Page - Action. Example: Onboarding - Welcome Screen - Completed Profile."
-
Developer-friendly (best for technical teams). Uses a snake_case or camelCase convention that mimics your internal event tracking.
Prompt:
"All tags should be in lowercase snake_case. Start with the platform (web/ext), then the page, then the specific UI component. Example: web_settings_billing_toggle."
-
Breadcrumb (best for nested navigation). Helps users understand exactly where a feature lives within the app hierarchy.
Prompt:
"Use a breadcrumb style separated by double colons. The name should represent the path the user takes. Format: Top Level :: Sub-Menu :: Specific Feature. Example: Settings :: User Management :: Invite New User."
Tips for writing your own conventions:
- Be explicit about separators. Tell the AI exactly which symbols to use (for example,
|,-,/, or::) - Define the casing. Specify if you want sentence case, title case, lowercase, or uppercase
- Mention what to exclude. If you want to avoid generic names, add a rule like: "Do not use generic names like 'Click Here' or 'Button 1'. Always include the functional context."
- Include an example. The AI performs best when you provide one example of a perfect tag name within your convention:
Examples:
Pages: [Section] | [Module] - {View}
- Prospects | Prospects - Overview
- Settings | List - View
- Marketing | List - Create
- Admin | Demo Orgs
Features: [Module] - {Page} | [Action] - {Type}
- Email Editor | Edit - Tab
- Marketing | List - Add List
- Prospect - Opportunities | Add Opportunity - Button
Take action
Use this view to align your tag names and improve your workflow. To view available actions, hover over a tag's row and select Actions. Choose from the following options:
- Update name. Accepts the suggested name. The Last updated by field is updated to the user who accepted the suggestion
- Reject name. Rejects the suggested name. Rejected suggestions won't be shown again
You can also take action on multiple tags at once. For more information, see Bulk actions.
Download tag maintenance data
You can download the contents of the Broken tags or Unused tags table as a CSV file so you can manage and audit your tags offline. Select the download icon in the top-right corner of either table.
Exclude and include tags
You can exclude broken or unused tags from Tag maintenance to simplify your view without losing historical data. Excluded tags are hidden from the table and removed from the Tag health score calculation. This is useful when a Page or Feature no longer exists in your app but you still rely on the tag for analytics.
Note: Excluding a tag doesn't impact analytics, segments or reports. The only changes are to the Tag health score and the tag's visibility in the Broken tags or Unused tags tables in the Tag maintenance feature.
Exclude a tag
- In the Broken tags or Unused tags table, hover over the tag's row.
- Select Actions.
- Select Exclude tag.
The tag is removed from the table view and the Tag health score is recalculated.
Include an excluded tag
You can view and re-include an excluded tag at any time to restore it to the default Tag maintenance view.
- In the Broken tags or Unused tags table, turn on the Only display excluded tags toggle.
- Hover over the excluded tag's row.
- Select Actions.
- Select Include tag.
The tag returns to the default table view and the Tag health score is recalculated.
Bulk actions
Take action on multiple tags at once in the Broken tags, Unused tags, or Naming Suggestions table. Select the checkboxes next to multiple tags, or select all tags using the checkbox in the table header. The number of selected tags and available bulk actions appear at the top of the table.
Note: Selecting all tags applies only to the tags visible in the current table (up to 500), not across tables.
Overview tab
The following bulk actions are available in the Broken tags and Unused tags tables:
- Delete selected. Deletes all selected tags. Tags with dependencies, such as associated guides, segments, or reports, can't be deleted. If a page has features tagged to it, it also can't be deleted
- Exclude selected. Excludes all selected tags from the default Tag maintenance table view and recalculates the tag health score
- Include selected. Restores all selected excluded tags to the Tag maintenance table view and recalculates the tag health score. This option is available when viewing excluded tags using the Only display excluded tags toggle
AI Name Suggester tab
The following bulk actions are available in the AI Name Suggester table:
- Accept selected. Accepts the suggested names for all selected tags
- Reject selected. Rejects the suggested names for all selected tags