> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hologram.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tag SIMs

> Organize and manage your SIM fleet with tags. Tags help you categorize and report on SIMs by deployment location, device type, fleet customer, or any other criteria you choose.

## What are SIM tags?

Tags are labels you can apply to SIMs to:

* Group related SIMs together (e.g., "Chicago Office", "Temperature Sensors", "East Coast", "v2 hardware").
* Filter and search for specific groups of SIMs.
* Apply bulk actions to tagged groups.
* Generate reports and analytics by tag categories.

## How to tag a single SIM

1. Open a SIM from the SIMs pages or using global search.
2. Press the tags field in the header.
3. In the Tags modal that appears, add or remove existing tags or create new ones.
4. Confirm your selection.

## How to tag SIMs in bulk

When bulk tagging SIMs, you can see tags that are already applied to some or all of the SIMs you've selected.

1. Navigate to the **SIMs** pages in your dashboard, and use filters to find the SIMs you want to tag.
2. Select SIMs by checking the boxes next to each SIM.
3. Click the **Manage SIMs** menu at the top of the page.
4. Choose **Manage tags**.
5. Add or remove existing tags or create new ones.

## How to tag SIMs during Activation

During the [activation process](/dashboard/activation/activation-overview) or when changing data plans, you can apply tags to the SIMs you've selected after choosing a data plan.

## How to edit or remove tags from SIMs using the REST API

<Card title="List all tags" href="/api/1/devices/tags/get" horizontal>
  List all tags <code>GET /devices/tags</code>
</Card>

<Card title="Create tag" href="/api/1/devices/tags/post" horizontal>
  Create a tag <code>POST /devices/tags</code>
</Card>

<Card title="Update tag" href="/api/1/devices/tags/tagid/updatetagname/put" horizontal>
  Update tag name <code>PUT /devices/tags/{tagId}/updatetagname</code>
</Card>

<Card title="Delete tag" href="/api/1/devices/tags/tagid/delete">
  Delete a tag <code>DELETE /devices/tags/{tagId}</code>
</Card>

<Card title="Add tag to SIMs" href="/api/1/devices/tags/tagid/link/post" horizontal>
  Add tag to SIMs <code>POST /devices/tags/{tagId}/link</code>
</Card>

<Card title="Remove tag from SIMs" href="/api/1/devices/tags/tagid/unlink/post" horizontal>
  Remove tag from SIMs <code>POST /devices/tags/{tagId}/unlink</code>
</Card>

## Limitations

* Tags are organization-specific and not shared across organizations.
* Updating a tag is an immediate change.
* Transferring SIMs between organizations does not transfer tags.