> 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](https://docs.enginsight.com/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="https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/management/global-tags/add-global-tag.md#tag-label">tag labels</a> and their associated <a href="https://docs.enginsight.com/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="https://docs.enginsight.com/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="https://docs.enginsight.com/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](https://docs.enginsight.com/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](https://docs.enginsight.com/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 you can configure additional export settings.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FxPhxt5tkVL0BZUmG8864%2Fenginsight-screenshot-hosts-management-tag%20manager-export%20tag%20manager.jpg?alt=media&amp;token=538fc059-c535-46af-8852-ec678d741b01" alt="" width="375"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Export all** after configuring all settings to download all tag managers that can be exported. 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 **Abort** to return to the list overview.

### Assigned Tag Managers

Here you can specify which tag managers should be exported.

{% hint style="info" %}
Specifying assigned tag managers is optional.
{% endhint %}

<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 Tag Managers

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

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

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Define Exceptions** to show the options for **Excluded Tag Managers**.

<i class="fa-gear">:gear:</i> Configure all settings in the same way as for an [assigned tag manager](#assigned-tag-managers).

### Direct References

Here you can specify how objects that contain direct references should be handled during export. Direct references are objects referenced by ID (for example, hosts) that cannot be transferred to other environments.

The following options are available:

| Option                              | Description                                                                                                                |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Skip Entries with Direct References | Select this option to exclude objects that contain direct references from the export. This option is selected by default.  |
| Strip Direct References             | Select this option to also export objects that contain direct references. The direct references are removed during export. |

***

## 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 [configured settings](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/management/tag-manager/add-tag-manager.md#basic-settings) and delete the tag manager.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FOexOaipO4AkTOHFRxdZh%2Fenginsight-hosts-management-tag%20manager-edit%20view.jpg?alt=media&amp;token=97d79284-ca47-4570-b161-6782602e2de9" alt=""><figcaption></figcaption></figure>

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>

***
