> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/management/tag-manager.md).

# Tag Manager

The tag manager allows you to automatically assign or remove tags from hosts when specific custom conditions are met or no longer met for the assigned hosts.

***

<i class="fa-compass">:compass:</i> Navigate to **Hosts** → **Tag Manager** to show a list of all configured tag managers. If you have not created a tag manager yet, this view is empty.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FxwgsKRMt8j0YikuJ1vuJ%2Fenginsight-screenshot-hosts-management-tag%20manager.jpg?alt=media&amp;token=308a2ea8-7f9b-4ab4-842e-428f3ab97404" alt=""><figcaption></figcaption></figure>

The [tag manager overview](#tag-manager-overview) provides information such as:

* which rules exist.
* which tags are assigned to the corresponding rules.

You can also [export tag managers](#export-tag-manager) or [create new tag managers](/docs/manual/english/platform-usage/hosts/management/tag-manager/add-tag-manager.md).

***

## Navigation

<i class="fa-magnifying-glass">:magnifying-glass:</i> Click the **Text Search** field above the list and enter a search term of your choice to find specific list items more quickly.

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Refresh** icon <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i> above the list to update all list items.

<i class="fa-computer-mouse-scrollwheel">:computer-mouse-scrollwheel:</i> Scroll down the list or adjust the number of results shown per page ![](https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FfjKACCt2SKXcFd3S7Xb5%2FEnginsight-EN-Results%20per%20Page.jpg?alt=media\&token=e1650160-7a41-4965-aaca-6975db758dbe) to view additional entries. Use the page navigation ![](https://content.gitbook.com/content/V7OrHgKXA0t1jankQBYf/blobs/wnxVw06QGoSsYjhwMJRF/Enginsight-Seitennavigation-2.jpg) to switch between pages.&#x20;

### Filtering the List

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Filter** icon <i class="fa-filter">:filter:</i> above the list to filter the list by predefined parameters.

<details>

<summary>Available Filters</summary>

<table><thead><tr><th width="206.60546875">Parameter</th><th width="116.515625">Type</th><th>Description</th></tr></thead><tbody><tr><td>Host</td><td>String</td><td>Filter for all tag managers assigned to a specific host, or exclude that host from the results. All available hosts are shown.</td></tr><tr><td>Host Tag</td><td>String</td><td>Filter for all hosts with a host-specific tag, or exclude them from the results. All available host tags are shown.</td></tr><tr><td>strict</td><td>Boolean</td><td><p>Filter based on whether the option <strong>Strict Mode</strong> is enabled for the tag manager.<br><br>This means that assigned tags are automatically removed from hosts as soon as a defined condition is no longer met.<br><br>The following values are available:</p><ul><li><strong>True</strong>: The Strict Mode option is enabled.</li><li><strong>False</strong>: The Strict Mode option is disabled.</li></ul></td></tr><tr><td>Tag</td><td>String</td><td>Filter for all hosts with a custom global tag, or exclude them from the results. All available global tags are shown.</td></tr></tbody></table>

</details>

### Sorting List Items

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Sort** icon <i class="fa-sort">:sort:</i> next to a column name in the table header to sort by that column in ascending <i class="fa-angle-up">:angle-up:</i> or descending order <i class="fa-chevron-down">:chevron-down:</i> .

<i class="fa-computer-mouse">:computer-mouse:</i> Click the sort icon <i class="fa-bars-sort">:bars-sort:</i> above the list to adjust the priority of the applied sorting. A menu opens that shows all columns by which the list is currently sorted. Drag and drop the shown items to change the sorting priority.

### Further Actions for List Items

<i class="fa-computer-mouse">:computer-mouse:</i> Select the checkbox <i class="fa-square">:square:</i> next to a list item to select the respective item. Alternatively, select the checkbox in the table header to select all list items.

The number of selected list items is now shown next to the search field.

The <i class="fa-slider">:slider:</i> **Actions** menu also appears in the upper-right corner. Click it to expand the respective submenu. The following actions are available:

<table><thead><tr><th width="189.94921875">Action</th><th>Description</th></tr></thead><tbody><tr><td>Export Selection</td><td><p>Export all selected tag managers. The file is exported in ZIP format. </p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>You can find the exported file in the default download location. of your browser.</p></div></td></tr><tr><td>Delete</td><td><p>Delete all selected tag managers. To do so, confirm the message that appears with <strong>Permanently delete</strong>.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note</strong>: Deleted settings are permanently lost.</p></div></td></tr></tbody></table>

***

## Tag Managers: Overview

The tag manager overview is structured as a table.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FDdoG7RnDvDAimsjMcBSX%2Fenginsight-screenshot-hosts-management-tag%20manager-overview.jpg?alt=media&amp;token=fa6a94de-bf0d-4bf5-9ac0-2a3afcbb2503" alt=""><figcaption></figcaption></figure>

The following information is shown:

<table><thead><tr><th width="199.921875">Column</th><th>Description</th></tr></thead><tbody><tr><td>Rule</td><td>Shows the custom name of the tag manager and an additional description, if provided. <br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a tag manager to navigate to the respective <a href="#tag-manager-edit-view">edit view</a>. There you can adjust the configured settings and delete the tag manager.</td></tr><tr><td>Tags</td><td>Shows all <a href="/docs/manual/english/platform-usage/hosts/management/global-tags/add-global-tag.md#tag-label">tag labels</a> and their associated <a href="/docs/manual/english/platform-usage/hosts/management/tag-manager/add-tag-manager.md#managed-value">tag values</a> that are managed by the respective rule.</td></tr><tr><td>Assigned References</td><td><p>Shows the names of the hosts to which the respective tag manager applies or which are excluded from it, as well as the tags that reference the respective host groups.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Whether host names, tags, or both are shown depends on the <a href="/docs/manual/english/platform-usage/hosts/management/tag-manager/add-tag-manager.md#assigned-references">settings for the assigned hosts</a> that you configured for the respective tag manager.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a host to navigate to the respective <a href="/docs/manual/english/platform-usage/host-detail-view.md">host detail view</a>.</p></td></tr><tr><td>Created At</td><td>Shows the date and time the tag manager was created.</td></tr><tr><td>Updated At</td><td>Shows the date and time the tag manager was last edited.</td></tr></tbody></table>

***

## Adding a Tag Manager

You have two options for adding a tag manager. You can either create new tag managers or import tag managers that you previously exported, for example from other organizations.

### Option 1: Creating a New Tag Manager

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Tag Manager** in the upper-right corner and select <i class="fa-plus">:plus:</i> **Create New** from the submenu that opens to [create a new Tag Manager](/docs/manual/english/platform-usage/hosts/management/tag-manager/add-tag-manager.md#create-tag-manager).

### Option 2: Importing a Tag Manager

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Tag Manager** in the upper-right corner and select <i class="fa-up-from-line">:up-from-line:</i> **Import** from the submenu that opens to [import one ore more Tag Managers](/docs/manual/english/platform-usage/hosts/management/tag-manager/add-tag-manager.md#import-tag-manager).

***

## Exporting Tag Managers

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-down-to-line">:down-to-line:</i> **Export Tag Manager** in the upper-right corner to open a new window in which all available tag managers are selected for export by default.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FoksXE7QE09eSjhHzfznj%2Fenginsight-screenshot-hosts-management-tag%20manager-export%20tag%20manager.jpg?alt=media&amp;token=4b9eaa0f-ad59-4c42-ae94-b424487fe36a" alt="" width="375"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Export all** to download all or only the selected global tags. The export is provided in ZIP format.

{% hint style="info" %}
You can find the exported file in the default download location of your browser.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Cancel** to return to the list overview.

### Assigned References

Here you can specify which tag managers should be exported.

<i class="fa-computer-mouse">:computer-mouse:</i> To do this, click the **Tag Managers** field to expand a list of all available tag managers and select one or more tag managers to export.

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Remove** icon <i class="fa-circle-x">:circle-x:</i> next to an added tag manager to remove it from the **Tag Managers** field again.

#### Excluded References

Here you can specify which global tags should be excluded from the export.

{% hint style="info" %}
Specifying excluded references is optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Define Exceptions** next to **Assigned References** to display the options for **Excluded References**.

<i class="fa-gear">:gear:</i> Configure all settings in the same way as for an assigned reference.

### Direct References

Here you can specify how direct references should be handled during export. Direct references are objects referenced by ID, such as specific hosts, that cannot be transferred to other environments.

The following options are available:

<table><thead><tr><th width="265.6875">Option</th><th>Description</th></tr></thead><tbody><tr><td>Skip Entries With Direct References</td><td>Select this option to skip all tag managers that contain directly referenced objects and exclude them from the export. This option is selected by default.</td></tr><tr><td>Skip Direct References</td><td>Select this option to export all tag managers that contain directly referenced objects, but remove those objects from the respective tag manager.</td></tr></tbody></table>

***

## Tag Manager: Edit View

<i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a tag manager to navigate to the corresponding edit view. Here you can adjust the [configured settings](/docs/manual/english/platform-usage/hosts/management/tag-manager/add-tag-manager.md#basic-settings) and delete the tag manager.

The following actions are available:

<table><thead><tr><th width="200.39453125">Option</th><th>Description</th></tr></thead><tbody><tr><td>Save Changes</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Save Changes</strong> after adjusting any settings.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note:</strong> Unsaved changes cannot be recovered.</p></div></td></tr><tr><td>Back</td><td><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Back</strong> to return to the list overview.</td></tr><tr><td>Remove</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Remove</strong>, then confirm the prompt that appears to delete the object that you are editing.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note:</strong> Deleted objects cannot be recovered.</p></div></td></tr></tbody></table>

***
