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

# Tags

> Organize and filter Push Notification and Live Activity history.

Tags help you organize Push Notification and Live Activity history around the people, customers, environments, or workflows that matter to you.

For example:

* `user:382`
* `billing`
* `environment:production`
* `order_9381`

## Add Tags

Add an optional top-level `tags` array when sending a Push Notification or starting a Live Activity. New tags are created automatically when you first use them.

### Push Notifications

```json theme={null}
{
  "title": "New subscription 💸",
  "message": "Customer upgraded to Pro plan",
  "tags": ["user:382", "billing"]
}
```

### Live Activities

```json theme={null}
{
  "content_state": {
    "title": "Search reindex",
    "subtitle": "catalog-v2",
    "type": "progress",
    "percentage": 42
  },
  "tags": ["user:382", "search-reindex"]
}
```

## Filter History

Use one or more tags to filter Push Notification and Live Activity history.

* Click a tag in Push Notification history to see Push Notifications with that tag.
* Click a tag in Live Activity history to see Live Activities with that tag.
* Open **Tags** in the ActivitySmith web app and click a tag to see its combined Push Notification and Live Activity history.
* When filtering by multiple tags, choose whether results must match all tags or any tag.

## Manage Tags

The **Tags** page in the ActivitySmith web app shows every tag and its usage across Push Notifications and Live Activities.

From there, you can:

* Search and sort tags.
* Rename a tag. The new name appears throughout notification history.
* Delete individual tags or select multiple tags for deletion.
* Delete all tags.

Deleting a tag removes it from associated history records. It does not delete the Push Notifications or Live Activities themselves.

## Tag Format

* Up to 20 unique tags per request.
* Between 1 and 64 characters per tag.
* Supported characters: lowercase letters, numbers, dashes (`-`), underscores (`_`), periods (`.`), and colons (`:`).
* Tags are trimmed, converted to lowercase, and deduplicated.

See the endpoint documentation for complete request fields:

* [Send a Push Notification](/docs/api-reference/endpoint/push-notification)
* [Start or update a Live Activity](https://activitysmith.com/docs/api-reference/endpoint/live-activity-start)