OneSignal Help & Documentation

Welcome to the OneSignal New IA developer hub. You'll find comprehensive guides and documentation to help you start working with OneSignal New IA as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Discussions

Clearing Cache and Resetting Push Permissions

Reset browser push permissions and data

Even if your settings are configured correctly, if you had previously used incorrect settings, push notifications may not work due to invalid permission or background worker states. These steps will reset your site's notification permissions, clear your site's storage, and remove our background worker.

Reset Chrome on Desktop

  1. Click the "lock icon" next to your URL in the Chrome browser.
  2. Next to "Notifications" permission dropdown, select "Ask (default)" (if you do not see this skip to step 3).
  3. Click Cookies to open the browser's "Cookies in use" page.
  4. Find and select your site (if you do not see your site, skip to step 8).
  5. Click Remove.
  6. Click Done.
  7. You should see a dropdown prompt to "Reload the page". Click the Reload button.

If you have immediate Prompting setup, you should now see a prompt on your site. Do not attempt to subscribe to your site yet.

  1. If you are using a label like yourlabel.os.tc you will need to follow the above steps again for this os.tc site.

Optional: Visit chrome://serviceworker-internals/ in a new tab and press the 'Stop' and 'Unregister' buttons under any Scopes that contain yoursite.domain or yourlabel.os.tc. If they won't remove, make sure all tabs or windows pointing to either domain are closed.

👍

Done!

Open a new tab to your site and try it out!

Reset Chrome on Android

If you still have a notification from your site visible in your notification drawer:

  1. Click the gear icon and 'Site Settings'.

  2. Click 'Clear & Reset'.

If you do not have a notification open, open Chrome on Android, tap the 3-dot menu, Settings, Site settings (under Advanced), Notifications, make sure it's set to "Ask before sending (recommended)". Find your site on the list, click the entry, and click Clear and Reset.

👍

Done!

Open a new tab to your site and try it out!

Reset Firefox on Desktop

🚧

If you have selected My Site is Not Fully HTTPS and have chosen a label for your site (e.g. mylabel.os.tc), you will need to follow these steps for your label's URL (e.g. mylabel.os.tc), not for your site's normal URL.

  1. Click the "i" or "lock" icon next to your site URL.
  2. Next to Receive Notifications under Permissions select the "X" button next to Allowed
  1. On the same dialog, at the bottom select Clear Cookies and Site Data...
  1. On the popup dialog that opens, click "OK"

🚧

HTTP or HTTPS sites with os.tc subdomain

Repeat the above process on the subdomain with os.tc

Reset Firefox on Android

Please follow this Firefox guide to clear all your browser data.

Reset Safari on macOS

Apple does not support Web Push on iOS (iPhone and iPad) or Safari on Windows.

On the top menu bar, go to:

  1. Safari > 2. Preferences > 3. Websites > 4. Notifications > 5. Select your site > 6. Click Remove to delete Notification Permissions f rom your site's entry.

Then select 7. Privacy > 8. Manage Website Data...

  1. Find and select your site > 10. Click Remove or Remove All (Remove All clears all site data).
  2. Click Done

👍

Done!

Return to your site and refresh the page, you should now access it like a first time visitor.

Updated 2 months ago


Clearing Cache and Resetting Push Permissions


Reset browser push permissions and data

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.