Docs

Tags

Audience

Open Audience → Tags (/audience/tags) to manage labels attached to subscribers. Tags power segment rules, broadcast targeting, and workflow logic.

Screenshot 2026-01-22 150519.png

Custom vs Default

  • Custom — tags you create in the console or via API; Owner and Editor can edit and delete
  • Default — platform tags seeded for every new project; read-only in the console

Default tags include New, Inactive, Paid, Role, IsAnonymous, IsDeviceless, HasDevices, EmailVerified, PhoneVerified, and LastActive. PushFire assigns and updates many of these automatically during registration and subscriber activity.

Tag list

The list loads with pagination and shows a loaded-vs-total counter in the header.

  • Search — press Enter to filter by tag name
  • Type — All, Custom, or Default

Each card shows name, description, active status, type badge, subscriber and segment counts, tag ID, and a View action.

Create a tag

Owner and Editor roles see New Tag in the header (hidden for Viewers).

  1. Select New Tag to open the create dialog.
  2. Fill in Name and Description (both required).
  3. Set Active (on by default).
  4. Select Create & Close to save.
Screenshot 2026-01-22 150532.png

Edit and delete

Open a tag from the list to view its detail page at /audience/tags/{tagId}.

  • Custom — Owner and Editor can update name, description, and active status, or delete (type the tag name to confirm). Deleting removes all subscriber and segment associations.
Screenshot 2026-01-22 150640.png
  • Default — read-only; the console shows an info alert and disables all fields

Below the form, the detail page lists segments that reference the tag and subscribers currently assigned to it.

Assigning tags

Tags are not assigned from the Audience UI. Add or remove them through:

  • SDK or REST API — primary method for app and backend integrations
  • Workflow nodes — automate tag changes as subscribers move through journeys

View assigned tags on each subscriber profile under Audience → Subscribers → Tags.

Operators and targeting

Segment conditions reference tags with an operator and an optional value:

  • Exists / NotExists — subscriber has (or lacks) the tag; no value needed
  • Equals / NotEquals — compare the tag value
  • Contains / NotContains — string containment on the tag value
  • GreaterThan / LessThan — numeric comparison on the tag value

When creating a broadcast under Messaging → Broadcast, set the target type to Tags and select one or more tags. See Segments for building rule-based groups from tag conditions.

Use cases

  • Lifecycle stages (trial, active, churned)
  • Product preferences or feature flags
  • Campaign cohorts for broadcasts and workflow branches

Roles

  • Owner / Editor — create, edit, and delete Custom tags
  • Viewer — browse tags and detail pages; cannot create or edit