Skip to main content

Browser Push Campaigns

Browser Push Notifications (also known as Web Push) let you send messages to customers directly through their desktop or mobile browser—even if not actively on your website. Once a user opts in, notifications can be delivered when they open their browser.

Updated over 3 weeks ago

Prerequisites

Before getting started, ensure you have:

Required Permissions

Campaigns can be accessed by users with one of the following roles:

  • Marketing

  • Marketing Analyst

  • Operator

  • Owner

⚠️ Important: Browser Push requires explicit user opt-in. Browsers allow only one opt-in request per browser per user.

What Are Browser Push Notifications?

Browser Push Notifications are messages sent through a web browser (desktop or mobile) after a user grants permission.

Key characteristics:

  • Delivered outside of your website

  • No app install required

  • Sent when the browser is open

  • Supported across major browsers and platforms

  • Require user consent via browser prompt

How Browser Push Opt-In Works

Automatic Opt-In Prompt (Recommended)

New customers are prompted to opt in the first time they open their Web Wallet.

Important behaviors:

  • Browsers only allow one opt-in request per browser

  • If the user declines, you cannot ask again

  • If the user clicks Allow, a second browser-level prompt appears

AIQ’s opt-in flow is designed to:

  • Allow users to choose “Later” instead of permanently declining

  • Comply with browser requirements that permission requests must follow a user gesture

Why This Matters (Browser Rules)

Browsers require that notification permission requests:

  • Are triggered by a user action (e.g. click or interaction)

  • Are not spammed or repeatedly shown

Mozilla and Safari already enforce these rules, and others follow similar standards.

How to Turn Browser Push Opt-In ON

Browser Push opt-in is enabled by default when Web Wallet is active.

New users will be prompted automatically the first time they open the Web Wallet.

How to Turn Browser Push Opt-In OFF

  1. Navigate to Settings > Mobile App > App Features

  2. Click the Features tab

  3. Under General, toggle OFF:

    • Browser notification opt-in (Web Wallet only)
      ​

How Customers Opt Out of Browser Push

Customers can opt out directly in their browser:

  1. Click the icon to the left of the website URL

  2. Find Notifications

  3. Change the setting to Block

Note: Opt-out steps vary slightly by browser.

How to Build Browser Push Campaigns

See Campaign Builder for full campaign setup details.

Notes Specific to Browser Push

  • You can add a Feature Image by clicking Add Media

  • You can preview the opt-in experience

  • You can send a test notification to yourself

Supported Browsers & Platforms

Browser Push support varies by browser and OS.

  • Refer to Supported Browsers documentation for the latest list

  • Support is dependent on browser capabilities

Anonymous / Private Browsing Limitations

Browser Push does not work in:

  • Incognito mode

  • Private browsing windows

These modes do not allow persistent subscriptions.

How the Sending Domain Works

Browser Push uses a subscription-based service:

  • Each user subscribes from a specific browser and domain

  • Once subscribed, opt-ins cannot be transferred

  • Subscribers cannot be moved between domains or origins

Moving or Importing Subscribers

Browsers do not support:

  • Importing subscribers

  • Migrating subscriptions across domains

  • Sharing opt-ins between origins

Each opt-in is browser- and domain-specific.

Browser Push Best Practices

Character Limits

Character visibility varies by platform and browser layout.

Platform

Title Limit

Body Limit

AIQ Recommendation

~20

~60

Windows – Chrome

~40–60

~120–150

Windows – Firefox

~40

~190

macOS – Chrome / Firefox / Safari

~40

~20–80

Emojis count as one character.
(Some limitations exist on Windows 7 and older OS versions.)

Images

  • Large images supported on:

    • Chrome (Windows, macOS, Android)

  • Use images sparingly to ensure fast delivery

Icons

  • Supported on all platforms

  • Customizable on Chrome and Firefox

Sounds

  • Not customizable for Web Push

Web Push Badges

  • Small icons shown in Chrome for Android

  • Appear in the notification center

Action Buttons

  • Custom buttons supported

  • Can link to different actions or URLs

Troubleshooting

Issue: User never received an opt-in prompt
​Solution: The browser may have already been prompted once and declined.

Issue: Notifications not sending
​Solution: Verify browser compatibility and that the user is not in private browsing mode.

Need Help?

If you need assistance, reach out to AIQ Support anytime via the chat widget within your AIQ Dashboard.

Did this answer your question?