Website Tags

Organize and categorize URLs within a website using custom tags for better navigation, filtering, and reporting.

Overview

Tags are website-specific organizational tools that help you categorize and manage URLs within each website. Tags are stored per organization and allow you to create logical groupings of pages based on your website's structure, content types, or business logic.

Accessing Website Tags

1. From Dashboard: Navigate to any website in your dashboard
2. Open Website View: Click on the website card to enter the website interface
3. Navigate to Settings: Click the "Settings" tab in the website interface
4. Select Tags Tab: Choose the "Tags" tab to manage your tag configuration

Tag Management

Creating New Tags

Add New Tag Button

• Click the "Add New Tag" button to create a custom tag
• Define the tag properties and URL matching criteria
• Tags take effect immediately for new scans

Tag Properties:

• Tag Name: Descriptive name for the tag (e.g., "Product Pages", "Blog Posts")
• Color: Visual identifier to distinguish tags in the interface
• Description: Optional description for team clarity

URL Matching Patterns

Define which URLs should be assigned each tag using flexible pattern matching:

Pattern Types

Starts With

• URLs beginning with the specified pattern
• Example: Pattern /products/ matches /products/item1, /products/category/shoes
• Use for: Section-based organization, directory structures
• Case sensitive: Patterns match exactly as specified

Contains

• URLs containing the pattern anywhere in the URL
• Example: Pattern blog matches /news/blog/post1, /about/blog-info
• Use for: Content type identification, cross-section features
• Flexible matching: Finds pattern in any part of URL

Equals

• URLs exactly matching the pattern
• Example: Pattern /contact matches only /contact, not /contact-us
• Use for: Specific important pages, exact page targeting
• Precise matching: Requires complete URL match

Pattern Examples

E-commerce Website:

• Product Pages: Pattern /products/ (Starts with)
• Category Pages: Pattern /category/ (Starts with)
• Checkout Flow: Pattern checkout (Contains)
• Homepage: Pattern / (Equals)

Blog Website:

• Blog Posts: Pattern /blog/ (Starts with)
• Author Pages: Pattern /author/ (Starts with)
• Tagged Content: Pattern tag= (Contains)
• Archive Pages: Pattern /archive/ (Starts with)

Corporate Website:

• About Section: Pattern /about/ (Starts with)
• Contact Forms: Pattern contact (Contains)
• Legal Pages: Pattern /legal/ (Starts with)
• News Articles: Pattern /news/ (Starts with)

Editing Existing Tags

Modify Tag Properties

• Update tag name, color, or description
• Changes apply to all URLs already tagged
• Historical data retains original tag associations

Update Matching Patterns

• Modify URL matching criteria
• New pattern applies to future scans
• Existing tagged URLs retain their tags unless re-scanned

URL Count Display

• See how many URLs are affected by each tag
• Monitor tag usage and effectiveness
• Identify overlapping or unused tags

Tag Analytics

Usage Statistics

• URL Count: Number of URLs currently tagged
• Scan Coverage: Percentage of tagged URLs scanned
• Issue Distribution: Accessibility issues per tag
• Trend Analysis: Tag usage over time

Performance Insights

• Most/Least Used Tags: Identify tag effectiveness
• Overlap Analysis: Find URLs matching multiple tags
• Orphaned URLs: URLs not matching any tag patterns
• Tag Efficiency: Ratio of tagged to total URLs

Deleting Tags

Tag Removal Process

• Select tag to delete from the tags list
• Confirmation dialog prevents accidental deletion
• URLs lose tag association but remain in website

Impact of Deletion:

• URLs retain scan data: Accessibility results remain
• Reports affected: Tag-based reports no longer include removed tags
• Filters updated: Tag filters remove deleted tags from options
• Historical data: Past reports may reference deleted tags

Best Practices

Tag Naming Strategy

Descriptive Names

• Use clear, descriptive names that reflect content or function
• Good: "Product Detail Pages", "User Account", "Navigation Menu"
• Avoid: "Tag1", "Misc", "Other"

Consistent Conventions

• Establish naming patterns across your organization
• Use title case or consistent capitalization
• Consider prefixes for large websites (e.g., "Shop: Products", "Blog: Posts")

Team Collaboration

• Document tag purposes for team members
• Use names that are meaningful to all stakeholders
• Avoid technical jargon in user-facing tag names

Pattern Design

Specific vs. General

• Start with broader patterns and refine as needed
• Balance specificity with maintainability
• Avoid overly complex pattern hierarchies

Pattern Testing

• Test patterns with sample URLs before applying
• Monitor tag assignment accuracy after creation
• Adjust patterns based on actual URL discovery

Maintenance Considerations

• Design patterns that accommodate website growth
• Plan for URL structure changes
• Document pattern logic for future updates

Color Organization

Visual Distinction

• Use distinct colors that are easily distinguishable
• Consider color blindness accessibility
• Maintain consistent color meaning across websites

Color Meaning

• Red/Orange: Critical pages, errors, high-priority content
• Green: Completed sections, positive content, success pages
• Blue: Information pages, documentation, standard content
• Purple: Special features, premium content, advanced functionality

Workflow Integration

Scanning Strategy

• Create tags before running comprehensive scans
• Use tags to prioritize scan areas
• Filter scan results by important tag categories

Reporting Workflow

• Export tag-specific reports for targeted analysis
• Use tags for stakeholder-specific reporting
• Track accessibility progress per content type

Team Organization

• Assign tag ownership to content teams
• Use tags to distribute accessibility responsibilities
• Create tag-based review workflows

Advanced Tag Usage

Nested Organization

Hierarchical Tagging While tags are flat, you can create logical hierarchies:

• E-commerce: "Products: Clothing", "Products: Electronics"
• Content: "Blog: Technical", "Blog: Marketing"
• User Flow: "Onboarding: Step 1", "Onboarding: Step 2"

Multi-tag Strategies

Overlapping Categories

• URLs can match multiple tag patterns
• Use complementary tags for different organizational needs
• Example: URL /products/sale/shoes might match "Products", "Sale Items", and "Footwear"

Cross-cutting Concerns

• Content Type: "Forms", "Videos", "Interactive Elements"
• User Type: "Public", "Member-only", "Admin"
• Priority: "Critical", "Important", "Standard"

Integration with Workflows

Development Integration

• Align tags with development team's URL conventions
• Use tags to identify areas needing accessibility review
• Tag new features for focused testing

Content Management

• Match tags to CMS categories or content types
• Use tags for content audit and maintenance
• Track accessibility improvements per content area

Troubleshooting

Common Issues

Tags Not Applying

• Check pattern syntax: Ensure patterns match actual URL structure
• Verify case sensitivity: Patterns must match URL case exactly
• Review URL format: Include or exclude query parameters as needed

Too Many/Few URLs Tagged

• Refine patterns: Make patterns more or less specific
• Check for conflicts: Multiple tags may be matching unintentionally
• Test with sample URLs: Verify pattern behavior before applying

Performance Issues

• Simplify complex patterns: Overly complex patterns can slow down processing
• Limit tag count: Large numbers of tags may impact interface performance
• Optimize pattern overlap: Reduce redundant or overly similar patterns

Pattern Testing

URL Pattern Tester

• Use browser developer tools to test URL matching
• Create test URLs to validate pattern behavior
• Document pattern testing results for team reference

Related Settings

• General: Basic website information and authentication
• Report Settings: Configure export paths and report formats
• Integrations: Connect with Jira and other external tools
• Scanning Options: Adjust global scan behavior and performance