Admin Guide

Users

A user is any visitor to your site or app who has ever interacted with the subscription prompt. The Users section gives a complete overview of your audience: statuses, tags, devices, and activity history.

What is a user

A user record is created automatically on the SDK's first contact with your site. A user can have multiple devices (browsers) — each is a separate subscription. One user can have several active subscriptions at the same time.

External ID

Your internal user identifier (ID from CRM, email, etc.). Set via SDK or API. If not provided — Notirix generates an anonymous ID. Used for sending messages to a specific person.

Last Seen

The time of the user's last visit to the site. Updated on every SDK call. Used in segments for the "active within N days" filter.

User statuses

Each user has one of three statuses. The status determines whether a notification can be sent.

active
Active

User allowed notifications and has an active push endpoint. Notifications are delivered.

unsubscribed
Unsubscribed

User revoked permission in the browser or their endpoint became invalid (browser returned 410). Notifications are not sent.

blocked
Blocked

Browser blocked notifications at the policy level (e.g. user declined three times). Notifications are not sent.

ℹ️
The unsubscribed status is set automatically when the browser returns a 410 Gone error — this means the subscription endpoint is invalid. Notirix cleans up such endpoints and does not waste delivery attempts.

Table columns

The users table shows key characteristics. Columns can be toggled with the "Columns" button in the toolbar.

ColumnDescription
External IDYour internal user identifier. If not provided — the anonymous Notirix ID is shown.
StatusCurrent status: active / unsubscribed / blocked.
Last SeenWhen the user last visited the site with an active SDK.
SubscriptionsNumber of active web push subscriptions (browsers/devices).
TagsNumber of tags set.
Created AtDate of the user's first appearance in the system.

Filters and search

Use the toolbar to quickly find users:

Search by ID

Enter the External ID or part of it. Search uses partial matching (substring).

Filter by status

Filter the list by status: All / Active / Blocked / Unsubscribed.

User tags

A tag is a key→value pair attached to a user. Tags are used for audience segmentation. For example, the tag plan = premium lets you create a "Premium Clients" segment and send them targeted campaigns.

js
// Tags are set via SDK
await sdk.setTag('user-42', 'plan', 'premium', 'YOUR_API_KEY')
await sdk.setTag('user-42', 'city', 'Moscow', 'YOUR_API_KEY')
await sdk.setTag('user-42', 'total_orders', 14, 'YOUR_API_KEY')

// Tags are used in segments:
// Rule: tag "plan" = "premium"  →  all users with plan=premium

Tags can be set in three ways:

1
Via Web SDK — sdk.setTag(userId, key, value, apiKey). Call on the frontend after user login.
2
Via REST API — POST /api/apps/:appId/users/:externalId/tags. Suitable for server-side integration and bulk updates.
3
Via Bitrix module — PushClient::setUserTags(). For sites on 1C-Bitrix.
💡
Tag values are strings or numbers. If a tag with this key already exists — it is overwritten (upsert). A tag with an empty string is considered non-existent and does not participate in segmentation.

User profile

Click on a row in the table to open the user's detail page. All information about a specific person is collected here.

User information

External ID, status, creation and last activity dates.

Tags

All set tags with keys and values. Used for segmentation.

Web subscriptions

List of browsers where the user granted notification permission: browser, OS, subscription date, endpoint status.

Mobile devices

FCM tokens of mobile apps (Android/iOS) connected via Mobile SDK.

Segments

List of segments this user falls into based on current rules.

Deleting a user (GDPR)

The "Delete user" button on the detail page deletes the user record along with all their subscriptions and tags. This is an irreversible operation. Use it to fulfill requests for personal data deletion (right to be forgotten).

⚠️
After deletion, the user will not receive notifications. If they grant notification permission again — a new record with a new ID will be created.

Related sections

→ Segments

User tags are the main segmentation tool. Create tags here, then use them in segment rules.

→ Messages

Via the targetUserId field (API) you can send a message to a specific user by their External ID.