Troubleshooting Push
This page helps you troubleshoot various issues you may experience with the Push messaging channel.
Missing push notifications
Experiencing delivery challenges with push notifications? There are a number of steps you can take to troubleshoot this issue by checking the:
- Push subscription status
- Segment
- Push notification caps
- Rate limits
- Control group status
- Valid push token
- Push notification type
- Current app
Push subscription status
Pushes can only be sent to subscribed or opted-in users. Check your user profile in the Engagement tab in the User Profile section to confirm if you are actively registered for push for the workspace that you are testing. If you are registered for multiple apps, you will find them listed in the Push Registered For field:
You can also export the user profiles using Braze export endpoints:
Either endpoint will return a push token object that includes push enablement information per device.
Segment
Make sure you fall into the segment that you are targeting (if this is a live campaign and not a test). In the User Profile, you will see a list of segments that the user currently falls into. Remember this is an ever-changing variable as segmentation is updated in real time.
You can also confirm that the user is part of the segment by using User Lookup when creating a segment.
Push notification caps
Check the global frequency caps. It’s possible you did not receive the push notification because your workspace has global frequency capping in place and you’ve already hit your push notification cap for the specified time frame.
You can do this by checking global frequency capping in the dashboard. If the campaign is set to abide by frequency capping rules, there will be a number of users impacted by these settings
Rate limits
If you have a rate limit set for your campaign or Canvas, you might be falling out of receiving messaging due to exceeding this limit. For more information, refer to Rate Limiting.
Control group status
If this is a single channel campaign or a Canvas with a control group, it’s possible you are falling into the control group.
- Check the variant distribution to see if there is a control group.
- If so, create a segment filtering for in campaign control group then export the segment and check if your user ID is on this list.
Valid push token
A push token is an identifier that senders use to target specific devices with a push notification. So, if the device does not have a valid push token, then there is no way to send a push notification to it.
Push notification type
Check that you’re using the correct type of push notification. For example, if you want to target a FireTV, then you would use a Kindle push notification, not an Android push campaign. Likewise, if you want to target an Android, use an Android push notification and not an iOS push campaign. Check out the following articles for more information on understanding the Braze workflow for:
Current app
When testing push sends with internal users, make sure that the user who you want to receive the push notification is currently logged into the relevant app. This can lead to the user either not receiving a push or receiving a push you believe they aren’t segmented for.
Push clicks unexpectedly open in app
If you’re experiencing issues with links in push notifications unexpectedly opening in your app instead of your web browser, there may be an issue with your campaign configuration or SDK implementation. Refer to these steps for help.
Verify on-click behavior
In your campaign or Canvas step, double-check that Open web URL inside mobile app is not selected. If it is, clear the selection and relaunch.
The default interaction for the on-click behavior “Open web URL” differs by SDK version. For SDK versions iOS 2.29.0 and Android 2.0.0 and higher, this option is selected by default and web URLs will open in a web view within the app. Prior to these versions, this option is cleared by default and web URLs open in the device’s default web browser.
If this is not the issue, there may be a problem with your push implementation.
Double-check push integration
If links in your push notifications are opening in the app unexpectedly, it might be due to issues with your push notification integration or customization settings. Follow these steps to troubleshoot:
- Review the push delegate implementation: Ensure that the Braze push delegate is implemented correctly. For detailed instructions, refer to the integration guide for push notifications for your platform.
- Inspect custom link handling: Check if the app includes custom handling for all
https://
links. Custom configurations might override default behaviors. Collaborate with your development team to review and adjust these settings if necessary. - Verify iOS push registration: For iOS, revisit step 1 of the push integration guide on registering push notifications with APNs. Ensure your delegate object is assigned synchronously before the app finishes launching. This step should be completed in the
application:didFinishLaunchingWithOptions:
method. - Test your integration: After making adjustments, test the push notification behavior on both iOS and Android devices to confirm the issue is resolved.
Web push notifications aren’t behaving as expected
If you’re experiencing issues with push notifications in your browser, you may need to reset your site’s notification permissions and clear your site’s storage. Refer to these steps for help.
Reset Chrome on desktop
- Next to your URL in the Chrome browser, select the View Site Information slider icon.
- Under Notifications, select Reset permission.
- Open Chrome DevTools. The following are the relevant shortcuts per operating system.
OS | Keyboard shortcuts |
---|---|
Mac | Fn + F12 Ctrl + Shift + I |
Windows | F12 Ctrl + Shift + I |
- In DevTools, navigate to the Application tab.
- In the sidebar, select Storage.
- Select Clear site data.
- Chrome will prompt you to reload the page to apply your updated settings. Select Reload.
Your push permissions are now reset. Open a new tab to your site and try it out.
Reset Chrome on Android
If you have a notification from your site visible in your Android notification drawer:
- From the push notification, tap and select Site settings.
- From Site settings, tap Clear & Reset.
If you don’t have a notification from your site open:
- Open Chrome on Android.
- Tap the menu.
- Go to Settings > Site Settings > Notifications.
- Verify notifications are set to Ask before sending (recommended).
- Find your site on the list.
- Select the entry and tap Clear and Reset.
Your push permissions are now reset. Open a new tab to your site and try it out.
Reset Firefox on desktop
- Next to your site URL, select or .
- Under Permissions, next to Receive Notifications, select to clear notification permissions.
- On the same menu, select Clear Cookies and Site Data.
- In the dialog to confirm your choice, select OK.
Your push permissions are now reset. Open a new tab to your site and try it out.
Reset Firefox on Android
To reset push permissions on Android, refer to this Mozilla support article.
Reset Safari on macOS
These steps are for macOS only, as Apple doesn’t support Web Push for Safari on Windows.
- Open Safari.
- From the menu bar on Mac, go to Safari > Settings > Websites > Notifications.
- Select your site from the list.
- Select Remove to delete notification permissions for the site.
- Then, go to Privacy > Manage Website Data.
- Select your site from the list.
- Select Remove, or to remove all site data, select Remove All.
- Select Done.
Your push permissions are now reset. Open a new tab to your site and try it out.
Still need help? Open a support ticket.