Tag management

Updated at:

Tags help you mark resources and categorize message templates, which simplifies searching and resource aggregation. You can add tags to, remove tags from, and filter message templates.

Overview

A tag is a label that you add to a message template. Each tag consists of a key-value pair. Managing a large number of message templates in Short Message Service can be complex. Tags help you group templates, which simplifies searching and data filtering.

Limitations

  • You can add a maximum of 20 tags to each message template.

  • The tag key must be unique for each message template.

  • This feature is available only for domestic text messages in Short Message Service on the Chinese mainland site.

Important
  • Tag management is only available for domestic text messages from Short Message Service on the mainland China site.

  • If you add two tags with the same tag key but a different tag value to a message template, the new value overwrites the existing one. For example, for the templatetest.example.com, if you first add the tagKey1:Value1 and thenKey1:Value2, the templatetest.example.com will have only the tagKey1:Value2.

Add tags

  1. Log in to the Short Message Service console.

  2. In the left-side navigation pane, choose Domestic Messages.

  3. On the Domestic Messages page, click the Template Management tab.

    • Add a tag to a single template

      1. In the Tag column, click Add.

      2. In the Edit Tag dialog box, enter the Tag Key and Tag Value, and then click OK.

        Tag configuration:

        Parameter

        Description

        Tag key

        A tag key can be up to 128 Unicode characters in length, and cannot start with aliyun or acs:, contain http:// or https://, or be an empty string.

        Tag value

        A tag value can be up to 128 Unicode characters, cannot start with aliyun or acs:, cannot contain http:// or https://, and can be an empty string.

    • Add tags to multiple templates

      1. Select the message templates that you want to tag. In the Set Tag bar at the bottom of the page, choose Add Tags in Batches.

      2. In the Add Tags in Batches dialog box, enter the Tag Key and Tag Value, and then click OK.

Remove tags

If a tag is no longer applicable to a message template, you can remove it. You can remove tags individually or in batches.

  • Remove a single tag

    1. In the Tag column, click Edit.

    2. Find the tag you want to remove and click the delete icon.

  • Remove tags in batches

    1. Select the message templates that you want to untag. In the Set Tag bar at the bottom of the page, choose Delete Tags in Batches.

    2. In the Delete Tags in Batches dialog box, select the tags you want to remove and click Delete Tags.

Filter by tag

After you add tags to message templates, you can use the tags to quickly find specific templates.

  1. On the Template Management tab, click Filter by Tag.

  2. Select one or more tags to filter the list and display the corresponding message templates.

Related APIs

API

Title

Description

ListTagResources Queries the tags of a template Tags are markers that you add to templates. Each tag consists of a key-value pair (Key-Value). You can query the template codes bound to a tag key-value pair, or query all tags bound to a specific template.
TagResources Add template tags Tags can mark resources, allowing enterprises or individuals to categorize templates of the same type for easier search and resource aggregation. Calls this operation to attach tags to SMS templates.
UntagResources Delete Template Tags Tags can mark resources, allowing enterprises or individuals to categorize templates of the same type for easier search and resource aggregation. If a template is no longer applicable to its currently bound tags, you can unbind the tags from the template. You can delete a single tag or delete tags in batches.