Apply billing tags

Billing tags are metadata elements that you can apply to Microsoft Customer Agreement MCA billing entities including billing profiles and invoice sections. Just like Azure tags, billing tags are key-value pairs that are used to identify the entities.

For example, to identify an invoice section with subscriptions belonging to the marketing department, you could use the tag with key : Department and value : Marketing. The fully formed key : value pair would be Department : Marketing.

Note

The limitations and recommendations that apply to Azure tags also apply to billing tags.

Warning

Tags are stored as plain text. Never add sensitive values to tags. Sensitive values could be exposed through many methods, including cost reports, commands that return existing tag definitions, deployment histories, exported templates, and monitoring logs.

Tag application

Required permissions Billing tags are applied in the Azure portal. The required permissions are:

  • Billing profile contributor/owner for billing profile tags
  • Invoice section contributor/owner for invoice section tags

Billing profile tags

  1. Go to https://portal.azure.com..
  2. Search for and select Cost Management + Billing.
  3. Select the billing profile where you want to set the tags.
  4. On the left menu, select Properties under Settings and then select Add or Update tags.
    Screenshot showing tag application to a billing profile.

Invoice section tags

  1. Go to https://portal.azure.com.
  2. Search for and select Cost Management + Billing.
  3. Select your billing profile.
  4. On the left menu, select Invoice sections under Billing.
  5. Select the invoice section where you want to set the tags.
  6. On the left menu, select Properties under Settings and then select Add or update Tags.
    Screenshot showing tag application to an invoice section.

Tag inheritance and billing tags

When you enable the Tag inheritance setting at the billing profile level, tags from billing profile and invoices sections are applied to usage records for all child resources. For more information about tag inheritance, see Group and allocate costs using tag inheritance.