In this section, we explain common issues that may occur during Bildirt setup and push notification delivery, along with how to resolve them.

Most issues are caused by incomplete or incorrect setup and can usually be resolved with a few simple checks.

Installation Not Verified

If the installation status cannot be verified in the Bildirt dashboard, it is usually because the installation code or required files are not properly loaded.

Things to check:

  • Is the installation code added to the <head> section of the site?
  • Is the installation code loaded on all pages?
  • Has cache and CDN been cleared?

manifest.json File Not Accessible

If the manifest.json file is not accessible, push subscriptions cannot be initiated.

Possible causes:

  • The file is located in the wrong directory
  • Cache or CDN is blocking the file
  • The file returns a 404 or 403 error

Suggested solutions:

  • Check by directly opening /manifest.json in your browser
  • If using a CDN, verify cache bypass settings

BildirtSDK-sw.js (Service Worker) Not Found

If the BildirtSDK-sw.js service worker file is not accessible, push notifications will not work.

Possible causes:

  • The file is in the wrong location
  • The service worker path is blocked due to cache or security policies

Suggested solutions:

  • Verify accessibility by opening /BildirtSDK-sw.js in your browser
  • Temporarily disable minify / defer / script optimization settings and test again

Push Notification Permission Not Showing

If the push notification permission prompt is not displayed to the user, it may be blocked at the browser level.

Possible causes:

  • The user may have previously denied permission
  • The browser may be blocking push notifications
  • The site may not be running over HTTPS

Suggested solutions:

  • Check site permissions in browser settings
  • Test using a different browser or incognito mode

Notification Sent but No Clicks

If notifications are successfully sent but no clicks are received, this is usually related to content or timing.

Things to check:

  • Is the notification title and description engaging enough?
  • Was the notification sent at the right time?
  • Are similar notifications being sent too frequently?

In this case, you can analyze and improve performance using the data on the Performance & Analytics page.

Auto Send Not Working (AI Autopilot)

If AI Autopilot is active but notifications are not being sent automatically, the settings should be checked.

  • Is AI Selection enabled?
  • Is Auto Send enabled?
  • Has the daily notification limit been reached?
  • Is the current time outside the defined time range?

After verifying these, the system will continue to operate automatically.

General Checklist

  • Is your site running over HTTPS?
  • Are manifest.json and BildirtSDK-sw.js accessible?
  • Has cache and CDN been cleared?
  • Are push permissions blocked in the browser?

If all these steps are correct, the Bildirt push infrastructure should work smoothly.