Manual Tag Editor

The Manual Tag Editor allows you to manually add, modify, or delete tags on AWS resources directly from the TagOps inventory page. This feature provides a convenient way to apply tags to specific resources without creating tagging rules.

Overview

The Manual Tag Editor enables you to:

  • Add tags to selected resources with custom key-value pairs
  • Delete tags from selected resources by removing specific tag keys
  • Bulk operations on multiple resources simultaneously
  • Protected tags - automatically prevents modification of tags managed by Tagging Rules

Accessing the Manual Tag Editor

  1. Navigate to the Inventory page
  2. Select one or more resources using the checkboxes in the first column
  3. Click the Modify Tags Manually button located near the "Refresh" and "Export CSV" buttons
  4. The Manual Tag Editor dialog will open

Button Availability

The "Modify Tags Manually" button is only enabled when you have selected at least one resource from the inventory.

Adding Tags

Step-by-Step Guide

  1. Select Resources: Check the boxes next to the resources you want to tag
  2. Open Editor: Click Modify Tags Manually
  3. Choose Mode: Ensure "Add Tags" mode is selected (default)
  4. Enter Tags:
  5. Click Add Tag to add a new tag row
  6. Enter the tag key in the "Key" field
  7. Enter the tag value in the "Value" field
  8. Repeat for additional tags
  9. Review Validation: The system will validate your tags and show any errors
  10. Submit: Click Apply Tags to save your changes

Tag Validation

The Manual Tag Editor validates tags according to AWS tagging restrictions:

  • Tag Key Requirements:
  • Maximum 128 characters
  • Must not start with aws: (reserved for AWS use)
  • Must not be empty or whitespace only

  • Allowed characters: letters, numbers, spaces, and these characters: + - = . _ : / @

  • Tag Value Requirements:

  • Maximum 256 characters
  • Can be empty (empty string)

  • Allowed characters: letters, numbers, spaces, and these characters: + - = . _ : / @

  • Tag Limits:

  • Maximum 50 tags per resource
  • Each tag key must be unique per resource

Managed Tag Protection

Tags that are managed by Tagging Rules cannot be manually edited or deleted. The system will:

  • Show a warning listing all managed tag keys at the top of the dialog
  • Prevent adding tags with keys that match managed tag keys
  • Filter out managed tags from the delete dropdown menu
  • Display validation errors if you attempt to modify protected tags

Managed Tags

If a tagging rule applies a tag to a resource, that tag key becomes "managed" and cannot be manually modified. This ensures consistency and prevents conflicts between automated and manual tagging.

Deleting Tags

Step-by-Step Guide

  1. Select Resources: Check the boxes next to the resources you want to modify
  2. Open Editor: Click Modify Tags Manually
  3. Choose Mode: Switch to "Delete Tags" mode using the toggle buttons
  4. Select Tags:
  5. A dropdown menu will show all deletable tags from the selected resources
  6. Tags managed by rules are automatically excluded
  7. Select one or more tag keys to delete
  8. Submit: Click Delete Tags to remove the selected tags

Empty Tag List

If all tags on the selected resources are managed by rules, you'll see a message indicating that no tags can be deleted.

Bulk Operations

The Manual Tag Editor supports bulk operations on multiple resources:

  • Select Multiple Resources: Use checkboxes to select multiple resources
  • Select All: Use the checkbox in the table header to select/deselect all visible resources
  • Apply Same Tags: All selected resources will receive the same tags when adding
  • Delete Same Tags: All selected tags will be removed from all selected resources

Efficient Tagging

Use bulk operations to quickly apply consistent tags across multiple resources, such as tagging all resources in a specific project or environment.

Operation Results

After submitting a tag operation, you'll see a summary notification showing:

  • Total resources processed
  • Successful operations count
  • Failed operations count
  • Details of any failures (if applicable)

Understanding Results

  • Success: Tags were successfully applied or removed from the resource
  • Partial Success: Some resources succeeded while others failed
  • Failure: The operation failed for one or more resources

Common failure reasons include: - Resource not found or deleted - Insufficient permissions - Resource in an invalid state - Tag limit exceeded