AWS Organizations
User Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Tagging AWS Organizations Resources

A tag is a custom attribute label that you add to an AWS resource to make it easier to identify, organize, and search for resources. Each tag has two parts:

  • A tag key (for example, CostCenter, Environment, or Project). Tag keys are case sensitive.

  • A tag value (for example, 111122223333 or Production). You can set the value of a tag to an empty string, but you can't set the value of a tag to null. Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case sensitive.

You can use tags to categorize resources by purpose, owner, environment, or other criteria. For more information, see AWS Tagging Strategies.

Supported Resources in AWS Organizations

Currently, AWS Organizations supports the following tagging operations when you are logged in to the master account:

  • You can tag and untag accounts in AWS Organizations.

  • You can view tags on an account in AWS Organizations.

AWS Organizations doesn't currently support tagging resources within an account, or the tag-based access control feature of AWS Identity and Access Management (IAM).

Adding Tags

When signed in with permissions to your organization's master account, you can add tags to accounts in your organization.

Minimum permissions

To add tags to accounts in your organization, you must have the following permissions:

  • organizations:ListTagsForResource (console only)

  • organizations:TagResource

To add a tag to an account in your organization (console)

  1. Sign in to the Organizations console at https://console.aws.amazon.com/organizations/. You must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization's master account.

  2. On the Accounts tab, choose an account.

  3. In the TAGS section of the details pane on the right, choose EDIT TAGS.

  4. Enter a key and, optionally, a value for the tag.

    Tag keys and values are case sensitive. Use the capitalization that you want to standardize on.

  5. Choose Save changes.

Any tags that you added to the account appear in the TAGS section of the details pane on the right.

To add a tag to an account in your organization (AWS CLI, AWS API)

You can use one of the following commands to add tags to accounts:

Viewing Tags on an Account

When signed in with permissions to your organization's master account, you can view tags on an account in your organization.

Minimum permissions

To view tags on an account in your organization, you must have the following permission:

  • organizations:ListTagsForResource

To view tags on an account in your organization (console)

  1. Sign in to the Organizations console at https://console.aws.amazon.com/organizations/. You must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization's master account.

  2. On the Accounts tab, choose an account.

  3. In the details pane on the right, find the TAGS section.

All tags that are attached to the selected account are displayed.

To view tags on an account in your organization (AWS CLI, AWS API)

You can use one of the following commands to view tags on an account:

Editing Tag Values

When signed in with permissions to your organization's master account, you can edit tag values on tags that are attached to accounts.

To edit tag keys, you need to delete the tag key and then add a new tag key. For more information, see Deleting Tags and Adding Tags.

Minimum permissions

To edit tag values on tags that are attached to accounts, you must have the following permissions:

  • organizations:ListTagsForResource

  • organizations:TagResource

To edit a tag value for a tag on an account in your organization (console)

  1. Sign in to the Organizations console at https://console.aws.amazon.com/organizations/. You must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization's master account.

  2. On the Accounts tab, choose an account.

  3. In the TAG section of the details pane on the right, choose EDIT TAGS.

  4. Modify the value of the tag that you want to change.

  5. Choose Save changes.

The TAGS section in the details pane on the right updates with any changes that you made to tag values for tags on the account.

To edit a tag value on an account in an organization (AWS CLI, AWS API)

  1. Delete the existing tag value by using one of the following commands:

  2. Add a new tag value by using one of the following commands:

Deleting Tags

When signed in with permissions to your organization's master account, you can delete tags that are attached to accounts in your organization.

Minimum permissions

To delete tags, you must have the following permission:

  • organizations:ListTagsForResource

  • organizations:UntagResource

To delete a tag from an account in your organization (console)

  1. Sign in to the Organizations console at https://console.aws.amazon.com/organizations/. You must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization's master account.

  2. On the Accounts tab, choose an account.

  3. In the TAGS section of the details pane on the right, choose EDIT TAGS.

  4. Choose Remove next to the tag to delete it.

  5. Choose Save changes.

The TAGS section in the details pane no longer displays the tags that you deleted.

To delete a tag from an account in your organization (AWS CLI, AWS API)

You can use one of the following commands to delete tags: