Tag Mapping

Tag policies are hard to enforce for two reasons:

  • You can create duplicate tags unintentionally when you make spelling, capitalization, and abbreviation errors, which makes it harder to reconcile your monthly bill.
  • If your initial tagging structure is not well thought-out, you may have to modify it later, which can be time-consuming and messy.

With the Tag Mapping feature, however, you can funnel the costs from your incorrect tags into a new tagging structure that is most beneficial to your deployment.


Let's say you decide to use the Environment tag key with a tag value for Development to tag your company's resources. However, you end up with resources tagged with the following variations:

  • environment | development
  • Environment | Dev
  • Env | Dev

Now, instead of keeping track of one tag, you must keep track of four tags.

This procedure will show you how you can create a master tag that will include all the tag variations:

  1. Launch CloudCheckr.
  2. Select an account from your Accounts List page.
  3. In CloudCheckr, go to the left navigation pane and choose Cost > Tags (from Detailed Billing) > Tag Mapping.
  4. At the top of the Tag Mapping page, go to the Map to Tag Key text field and type Environment
  5. In the Map to Tag Value text field, type Development
  6. Click Create.

    CloudCheckr creates a master tag and displays a new section that you will need to populate:

  7. In the Tag Key to Map text field, type Environment
  8. In the Tag Value To Map text field, type Development

    You can also click to map to a property in a selected Key/Value pair.

    In this example, we refine the Environment | Development Key/Value pair so that CloudCheckr only looks for costs in the us_east_1 region:

  9. Click to add another Key/Value pair.
  10. Add the remaining Key/Value pairs:
    • environment | development
    • Environment | Dev
    • Env | Dev
  11. Click Save.

    CloudCheckr displays your tag mappings:

    When CloudCheckr processes your next monthly billing file, it will map costs that match the Key/Value pairs in your new tag mapping. CloudCheckr will also display the Master Tag in your cost reports.

    Click Reload Billing Data to reprocess your billing report for any previous months where you want to apply your new tag mapping.
    Click Remove to delete a master tag. The deletion does not impact your cost data, but you must reprocess your billing report for these changes to take effect.
    Click Upload CSV to create tag mappings in bulk using a CSV file.

How did we do?