---
description: "How to configure browser push notifications"
---

# How to configure browser notifications

Browser notifications let you receive system notifications even when the tab is inactive. Useful for critical alerts you cannot miss.

## When it is useful

- You want notifications when the tab is in the background.
- You need critical alerts (SLA, CSAT).
- You work with many tabs.

## What to know

- **Browser notifications** are system notifications from the browser (Web Push).
- A **service worker** registers automatically to handle push.
- **Automatic subscription** — if the channel is mandatory, the system may subscribe you after login.

## Before you start

- Supported browser (Chrome, Firefox, Edge).
- **HTTPS** in production (local may work on HTTP).
- You are logged in.

## Automatic subscription

If an administrator set the browser push channel as **mandatory**, the system tries to subscribe you after a successful login.

**How it works:**
1. After login, the system checks whether the channel is mandatory.
2. If it is mandatory and you are not subscribed yet, it may:
   - Ask for browser notification permission (if not granted)
   - Create a push subscription
   - Save the subscription
3. If you are already subscribed, nothing else happens.
4. If automatic subscription fails (for example, you denied permission), you can subscribe manually.

**Important:**
- Automatic subscription failures do not block login.
- If you denied permission, you can allow it later in browser settings.
- After allowing, the system can complete subscription on the next login.

## Manual setup

If the channel is not mandatory or automatic subscription did not run:

### 1. Open notification settings

Go to **Profile** → **Notifications** → **Channels** tab.

### 2. Find browser notifications

Scroll to **Browser notifications** or **Push notifications** in the channel list.

### 3. Subscribe to push

Click **Subscribe to push notifications** (or the equivalent button).

### 4. Allow notifications in the browser

Accept the browser prompt — **Allow** / **Дозволити**.

### 5. Check status

After permission, the system registers your browser and creates a subscription.

Status should show **Subscribed**.

## Result

After a successful subscription you can:

- Choose browser notifications as a channel for any notification type
- Receive notifications when the tab is inactive
- Run **Test** on the channel

## Verification

1. Click **Test** next to browser notifications.
2. You should see a system notification.
3. It works even when the tab is inactive.

## Troubleshooting

### Permission denied

**Issue:** You denied browser notification permission.

**What to do:**
1. Open browser settings.
2. Find **Notifications** or **Sites**.
3. Allow notifications for the ConnectiveOne site.
4. Return to the app and subscribe again.

### Subscription not created

**Issue:** Permission granted but subscription is not created.

**What to do:**
- Use **HTTPS** in production.
- Confirm the browser supports Push API.
- Check the browser console for errors (F12 → Console).
- Refresh and try again.

### Notifications do not arrive

**What to do:**
- Confirm browser notifications are selected for the notification type.
- Run **Test**.
- Confirm permission was not revoked in browser settings.
- Ask your administrator if browser push is configured correctly for your environment.

### Automatic subscription did not run

**What to do:**
- Check the browser console (F12 → Console).
- Confirm the channel is mandatory (set by administrator).
- Subscribe manually from profile notification settings.

## Unsubscribe

1. Open settings → **Channels** tab.
2. Find **Browser notifications**.
3. Click **Unsubscribe**.
4. Subscription is removed; you can still select the channel in settings until you refresh choices.
5. To subscribe again, follow **Manual setup** above.

## Related guides

- [How to configure a notification for an event type](/en/notifications/how-to/configure-notification-type.md)
- [How to test a channel](/en/notifications/how-to/test-notification-channel.md)