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

# Push (Browser) Notifications

> Set up browser push notifications for new Upwork jobs — and fix it when they do not arrive.

Push notifications send new matching jobs straight to your desktop as system notifications — even when the Vollna tab isn't open or focused. They're the fastest way to be first to apply.

## How push notifications work

Before troubleshooting, it helps to know one thing: **push is tied to the exact browser, device, and profile where you allowed it.** It is *not* account‑wide.

* If you allow push in Chrome on your laptop, your phone, a second browser, or a different Chrome profile will **not** receive those notifications.
* Enable push separately in each browser you want alerts on.
* The browser must be running (at least in the background) to display a push.

> [!NOTE]
>
> Push works on top of three layers, in this order: **Vollna → your browser → your operating system.** Any one of them can silently swallow a notification. Most "I enabled push but nothing arrives" cases are the browser or OS layer, not Vollna.

## Step 1: Enable push

1. Go to **Dashboard** → **Notifications**.
2. Find **PUSH** under **Setup notifications & integrations** and click **Set up**.
3. Click **Turn on push**, then **Allow** in the browser prompt. The window shows **Push is on in this browser.**
4. Assign one or more [filters](https://www.vollna.com/docs/filters/overview.md) and click **Add notification**.

> [!WARNING]
>
> If you click **Block** (or dismiss the prompt) by accident, most browsers will stop asking and silently suppress push. The PUSH window then shows **This browser blocks notifications from vollna.com.** You'll need to reset the site permission — see [Reset and re-subscribe](#reset-and-re-subscribe) below.

## Step 2: Send a test notification

Open the **⋮** menu on your PUSH notification, click **Edit**, then click **Send test**. A system notification should appear within a few seconds.

> [!NOTE]
>
> "Test sent. Check your channel." and a recent **Last sent** time on the notification card mean Vollna delivered the push to the browser's push service correctly. If you still don't see anything on screen, the notification is being blocked **after** Vollna — by your browser or operating system. Work through the troubleshooting steps below.

## Not receiving push notifications?

You enabled push, but nothing arrives. Run these checks in order — Step 1 is the most important, because it tells you *which layer* is broken.

### Step 1 — Is it Vollna, or your browser / OS?

Open a neutral push test that has nothing to do with Vollna and click one of its test buttons:

> [card] [CleverPush test page](https://cleverpush.com/en/test-notifications/)
>
> Allow notifications, then click **Send test notification** on that page.

* **You don't receive that test either** → the problem is your **browser or OS**, not Vollna. Continue with Steps 3 and 4.
* **You do receive that test, but not Vollna's** → the problem is the **Vollna site permission specifically**. Jump to [Reset and re-subscribe](#reset-and-re-subscribe).

### Step 2 — Check the browser permission for vollna.com

The browser must have notifications set to **Allow** for `vollna.com`.

**1. Open the site permissions**

Click the padlock / tune icon to the left of the address bar while on a Vollna page.

**2. Find Notifications**

Make sure **Notifications** is set to **Allow** (not *Block* or *Ask*). In Chrome and Edge this is in the dropdown directly; in Firefox it's under the same padlock menu.

**3. Reload and re-test**

Reload the page and click **Send test** again.

> [!TIP]
>
> Allowing notifications for `vollna.com` in your browser only grants *permission*. It does not by itself prove notifications can reach your screen — the operating system still has to be allowed to show them (Step 3).

### Step 3 — Check your operating system

This is the layer most people miss. Even with browser permission granted, the OS can hide every notification.

> [accordion] Windows
>
> 1. **Settings → System → Notifications** — make sure notifications are **On**, and that your browser (Chrome / Edge / Firefox) is allowed in the per‑app list.
> 2. Turn off **Do not disturb** / **Focus assist** — it silences all banners, including push.
> 3. **Battery saver** can suppress background notifications. Disable it or plug in.
> 4. Allow the browser to **run in the background** (browser Settings → System → *Continue running background apps when the browser is closed*).

> [accordion] macOS
>
> 1. **System Settings → Notifications → \[your browser]** — turn on **Allow notifications** and choose **Banners** or **Alerts**.
> 2. Turn off **Do Not Disturb** and any active **Focus** mode (Control Center → Focus).
> 3. Check that notifications are allowed **when mirroring or sharing the display** if you use an external monitor.

> [accordion] Safari (macOS) & iPhone / iPad
>
> Web push has stricter requirements on Apple devices:
>
> * **Safari on macOS** supports web push from **macOS 13 (Ventura)** onward.
> * **iPhone / iPad** support web push from **iOS / iPadOS 16.4** onward — but only after you **Add Vollna to your Home Screen** (Share → *Add to Home Screen*) and open it from that icon. A regular Safari tab cannot receive web push on iOS.

### Step 4 — Browser & device specifics

> [accordion] Wrong browser or device
>
> Push is **per‑browser, per‑device, per‑profile**. If you allowed push in Chrome on your laptop, alerts will *not* show up on your phone or in a different browser. Enable push in each browser you actually watch.

> [accordion] Incognito / Private window
>
> Private / Incognito windows don't keep push subscriptions and won't receive notifications. Use a normal window.

> [accordion] Browser is closed
>
> On desktop the browser must be running (a background process is fine). If you fully quit it, you won't get live pushes until it's open again.

> [accordion] Privacy tools blocking it
>
> Brave Shields, ad/tracker blockers, and hardened privacy extensions can block the service worker or the push connection. Allow‑list `vollna.com`. A corporate VPN, proxy, or firewall can also block the browser's push endpoint (Google FCM, Mozilla, or Apple push).

### Reset and re-subscribe

If the permission got into a bad state (previously blocked, or pushes worked before and then stopped), reset it cleanly:

**1. Remove the permission**

Open the site permissions (padlock icon) for `vollna.com` and set **Notifications** back to **Ask** / default, or clear the site's permissions.

**2. Reload Vollna**

Refresh the dashboard so the page can request permission again.

**3. Re-enable push and Allow**

Open the **⋮** menu on your PUSH notification and click **Edit**. Click **Turn on push**, then **Allow** in the browser prompt.

**4. Send a test notification**

Confirm it works end‑to‑end.

## Still not receiving them?

If you've worked through every step and a neutral test like [CleverPush](https://cleverpush.com/en/test-notifications/) still doesn't reach you, the issue is at the browser/OS level rather than Vollna — but we're happy to help dig in.

[Contact our support team](https://www.vollna.com/contact) and include:

* Your **browser and version**, and your **operating system** (Windows / macOS / Linux + version).
* Whether the **neutral test** (Step 1) reached you.
* Whether **Send test** says "Test sent" and the notification card shows a recent **Last sent** time.

> [!TIP]
>
> Prefer alerts that don't depend on browser and OS settings? [Email](https://www.vollna.com/docs/notifications/email.md), [Telegram](https://www.vollna.com/docs/notifications/telegram.md), [Slack](https://www.vollna.com/docs/notifications/slack.md), and [Discord](https://www.vollna.com/docs/notifications/discord.md) deliver regardless of your local notification setup.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.