---
sourceDocument: Brazil IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-operations-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Modify or update tag definitions for tag-based mapping

# Modify or update tag definitions for tag-based mapping {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read  
You can change tag definitions that Service Mapping uses for tag-based
mapping. Service Mapping uses updated
tag definitions to create new tag-based services without applying tag-related changes to
services you mapped earlier.

## Before you begin

If you need to create a new tag category or modify an existing tag category,
follow the prerequisites in [Map application services using tags with classic Service Mapping](https://www.servicenow.com/docs/UM6teArLEb2Bbgvj5o6ErQ "Use tags that help categorize and organize configuration items (CIs) in your organization to map application services. Tag-based mapping doesn't require configuring credentials or providing users with elevated rights.").

Review
recommendations in [Prepare for mapping application services based on tags](https://www.servicenow.com/docs/5QMDHcxxC_pVMWXFenYXlA "Analyze, review, and define tags in your organization for successful mapping.").
Role required: service_mapping_admin

## About this task

Note:  
Starting with Service Mapping Plus version 1.16.3, take advantage of the Tag-based Service Mapping workspace to efficiently map you application services. For more information, see [Tag-based mapping in the Service Mapping Workspace](https://www.servicenow.com/docs/7N5AIunHyLAiuZo4UvqDtw "The Tag-based service mapping dashboard offers an intuitive way to manage tag-based services. Use the widgets, data visualizations, and list navigation to review and update your services, or create new tag-based services in a few steps. The dashboard enhances the Service Mapping Workspace, offering an efficient and user-friendly interface for organizing and optimizing your service mappings.") and [Tag-based discovery for the Service Mapping Workspace](https://www.servicenow.com/docs/JPo7F1C5YvJPbmCZJ4p9Ew "If your organization uses tags for asset management, you can use the Service Mapping workspace to manage these tags and create tag-based application services.").  
You may decide to add or remove tag categories from a tag-based service family in the following cases:

* If you are not satisfied with the results of the tag-based mapping, for example, if the service is too large, because it includes irrelevant CIs.
* If there are changes in the way your organization uses tags, for example there are new tags.

{#modify-tag-category-family__ul_dxw_524_cjb}When you modify tag categories defined for a tag-based service family or delete a tag-based family itself, the system detaches all mapped services from this tag-based service family. These services still exist and Service Mapping continues to update them using the original tag definition. To avoid having tag-based services based on outdated tag definitions, delete existing tag-based services.  
Service Mapping generates new tag-based service candidates that you use to map services based on modified tag definition.  
Important:  
New services based on modified tag definitions do not overwrite previously mapped services.

## Procedure

1. Delete existing tag-based services:
   1. Navigate to Service MappingAdministrationTag-based Service Families.
   2. Select the tag-based service family for which you want to modify the tag definition.
   3. Under Mapped services, click Delete mapped services to delete all services.
   4. Alternatively, click the Mark for deletion icon next to the relevant service in the list, and then click Delete.
   {#modify-tag-category-family__substeps_mr4_mlc_xnb}
2. Navigate to Service MappingAdministrationTag-based Service Families.
3. Select the tag-based service for which you want to modify the tag definition.
4. Under Selected tag categories, perform one of the following actions:  
   * Add a new tag category by double-clicking the empty row and selecting the relevant tag category from the list of tag categories you defined earlier.
   * Remove a tag category by clicking the Mark for deletion icon next to it.
   * Modify the use of a tag category already associated with the service family by changing the tag values or the service naming order. For
     multiple tag values, use comma as a separator. The service naming
     order defines how Service Mapping uses the tag
     category name in the names of application services generated for the
     service family.

   * Modify the tag category itself by clicking the tag category name and then defining the CI tag keys.
   {#modify-tag-category-family__ul_ssh_rj4_cjb}
5. Click Update.

## What to do next

[Remap tag-based application services to reflect tag changes](https://www.servicenow.com/docs/SporNXLHWsI7TZzfwQ0wiw "Recreate tag-based services if the way your organization uses tags have changed or after modifying tag definitions for tag-based service families.")
**Related concepts**   

* [Review and approval of application service maps](https://www.servicenow.com/docs/oI2M6SbS5hbPyK0cr_BVGQ "After the Service Mapping administrator maps IT services and fixes errors in them, the administrator and the owner collaborate to review and approve the service maps. The review and approval process is available only for discovered and manually created service instances.")
* [Application service completion](https://www.servicenow.com/docs/69FXKYAtjTwb1OLdUUkNUg "After an application service is reviewed and approved, you can define attributes that enhance its discovery, reflect its importance, and control access to it.")
* [Application service analysis and maintenance using classic Service Mapping](https://www.servicenow.com/docs/WTz5wtNdvqvxJp~A8hpEvQ "Service Mapping creates maps to help you see the architecture and organization of application services. These maps are useful for planning change or migration, as well as analyzing the continuity and availability of services.")  
**Related tasks**   

* [Map multiple application services suggested by classic Service Mapping](https://www.servicenow.com/docs/SoMUNP6IUs9UZEso4Cu1Rw "You can map multiple application services identified and suggested by Service Mapping in a single operation. This method suits your organization if you do not have much information about application services.")
* [Map application services using tags with classic Service Mapping](https://www.servicenow.com/docs/UM6teArLEb2Bbgvj5o6ErQ "Use tags that help categorize and organize configuration items (CIs) in your organization to map application services. Tag-based mapping doesn't require configuring credentials or providing users with elevated rights.")
* [Map multiple application services from a CSV file using classic Service Mapping](https://www.servicenow.com/docs/xZVwmZmCkT90zA2r9Bp55w "This method suits you if your organization has performed cross-organization mapping and analysis and collected some information about planned service instances. If so, you can organize the collected information in a specific order and save it as a CSV file. Service Mapping extracts information from this file and creates potential service instances referred to as service candidates.")
* [Map a single application service using classic Service Mapping](https://www.servicenow.com/docs/84H~9XLTgWAhfiOXgG6MnQ "In addition to mapping application services in bulk, you can map individual, single application services by defining attributes for each application service. Use this mapping method if you already know or are planning to find out application service details. You must have Service Mapping enabled to map or review application services.")
* [Fix application service errors in bulk](https://www.servicenow.com/docs/54DTNMCTpY5GPpE2okJv7w "Service Mapping classifies errors by their root cause, for example, missing credentials or task timeout. For a fast and efficient process, fix errors belonging to the same category in bulk.")
* [Fix errors in individual application service maps](https://www.servicenow.com/docs/MCJ0VComQ4U05O3O4kckJw "You can address discovery issues in each application service map individually.")
* [Fine-tune application services to implement owner requests](https://www.servicenow.com/docs/7HdnzmIHxaB7cazo8hGXJQ "As an administrator, you tweak and fine-tune maps based on comments from the application service owner.")

*[\>]: and then