---
schema_version: "1"
id: 718bb6544925ae37b81db091b2f7892977c007316981a414e8c05435e1ca981c
title: Tag
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_tag.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_tag.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 3f0d0f53d2e7328bf92a74c54565895a74358515852537bc012d6ea6a8a3e2e9
description: Represents a named label that can be applied to Salesforce metadata records to categorize, describe, or classify them. Tags are organized within a TagSet, which defines the category they belong to. For example, a TagSet named DataDomain might contain Tags such as Financial, Operational, or Legal. Use Tag to define the individual classification values available in a category.
---
# Tag

Represents a named label that can be applied to Salesforce metadata records to categorize, describe, or classify them. Tags are organized within a TagSet, which defines the category they belong to. For example, a TagSet named DataDomain might contain Tags such as Financial, Operational, or Legal. Use Tag to define the individual classification values available in a category.

## Parent Type

This type extends the [Metadata](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/metadata.htm "The base class for all metadata types. You can’t edit this object. A component is an instance of a metadata type.") metadata type and inherits its fullName field.

## File Suffix and Directory Location

Tag components are stored in .tagset files as children of TagSet.

## Version

Tag components are available in API version 67.0 and later.

## Fields

| Field Name | Field Type | Description |
| --- | --- | --- |
| description | string | A description of the tag. |
| label | string | Required. Label that identifies the tag in the Salesforce user interface. |
| name | string | Required. The unique name of the tag. Can contain only underscores and alphanumeric characters and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. |
| options | [TagOption](#TagOption)\[\] | A list of options associated with the tag. |
| properties | [TagProperty](#TagProperty)\[\] | A list of properties associated with the tag. |

## TagOption

Represents an option associated with a tag.

| Field Name | Field Type | Description |
| --- | --- | --- |
| name | string | Required. The name of the option. |
| value | boolean | Required. The value of the option. |

## TagProperty

Represents a property associated with a tag.

| Field Name | Field Type | Description |
| --- | --- | --- |
| name | string | Required. The name of the property. |
| value | string | Required. The value of the property. |

## Wildcard Support in the Manifest File

This metadata type doesn’t support the wildcard character \* (asterisk) in the package.xml manifest file. For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).

Use the [listMetadata()](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_listmetadata.htm "This call retrieves property information about metadata components in your organization. Data is returned for the components that match the criteria specified in the queries parameter. The queries array can contain up to three ListMetadataQuery queries for each call. This call supports every metadata type: both top-level, such as CustomObject and ApexClass, and child types, such as CustomField and RecordType.") call to discover custom Tags and TagSets in your org.