Skip to main content

OneSignal

What is OneSignal?

OneSignal is a push notification platform that lets you send messages directly to your customers' browsers — even when they're not on your storefront. Unlike email, which is constantly filtered and ignored, web push notifications land on the device and get opened much more often. OneSignal has a generous free tier and is the most popular push provider for small and mid-size e-commerce stores.

Typical uses for an online store:

  • Abandoned cart reminders — "You left something behind!"
  • Back-in-stock alerts — notify customers the moment a sold-out product returns.
  • Promotions and flash sales — reach everyone who subscribed, instantly.
  • Order status updates — "Your order has shipped."

Customers only receive notifications if they explicitly accept the browser's permission prompt the first time they visit your storefront after OneSignal is installed.

How Nevuto handles OneSignal

  • Nevuto injects the OneSignal Web SDK into every page of your storefront as soon as you save the integration, configured with your App ID.
  • OneSignal's own SDK handles the permission prompt, the subscription lifecycle and the notification delivery — Nevuto doesn't touch or intercept any of it.
  • The content and targeting of every push campaign is configured inside the OneSignal dashboard. Nevuto just makes sure the SDK is loaded so subscribers can be captured and reached.
  • You can disable the integration at any time from the admin panel; the SDK is removed on the next page load (existing subscribers stay subscribed in OneSignal, but new prompts won't appear).

Add OneSignal to your Nevuto store

  1. Log in to your Nevuto admin panel.
  2. Go to Settings → Integrations.
  3. Click the Add button next to OneSignal.
  4. Paste your App ID into the input field.
  5. Toggle the status to Active and click Save.

Done — OneSignal starts asking visitors for push permission on your storefront immediately.

Where to find your App ID

  1. Sign in to onesignal.com.
  2. If you don't have an app yet, click New App/Website, choose Web, enter your storefront URL and follow the prompts. OneSignal will ask you to upload an icon and configure the initial prompt style.
  3. Open your app and go to Settings → Keys & IDs.
  4. Copy the OneSignal App ID — it's a UUID-like string (32 hex characters with dashes).
  5. Paste it into Nevuto's App ID field.

Test that it's working

  • Open your storefront in an incognito window (so your browser treats you as a first-time visitor).
  • Within a few seconds, OneSignal should show the permission prompt configured in your dashboard (slide-in, bell icon or native prompt, depending on your setup).
  • Click Allow.
  • Back in your OneSignal dashboard, open Audience → All Users. Your subscription should appear within a minute.
  • Send a test push: Messages → New Push → Send to a particular segment → All Users, write anything, and hit Send. The notification should pop up on the device you just subscribed with.

Troubleshooting

  • "OneSignal is not configured correctly" on save: the App ID must be a UUID-like string (32 hex characters plus dashes). Paste only the ID, not a full snippet.
  • Permission prompt never shows up: prompts only appear on HTTPS and only once per browser — clear OneSignal's cookies (or use a fresh incognito window) to see it again. Also confirm the integration status toggle is Active and that your OneSignal app is configured for the correct domain (OneSignal locks each app to a specific origin).
  • Prompt shows but subscriptions don't appear in the dashboard: check that the App ID in Nevuto exactly matches the one in OneSignal → Settings → Keys & IDs. Even a one-character mismatch breaks the link.
  • Notifications don't arrive after clicking Allow: browsers throttle push notifications aggressively if the user is idle. Test with the browser focused on the storefront.
  • Service Worker errors: OneSignal registers a service worker at /OneSignalSDKWorker.js. If another tool on your store also registers a service worker at the root path, they can conflict — reach out to OneSignal support for advanced setups.

Related articles