Services Plugins FAQs

Display issue plugin MapBox Maps

Plugins
#1

Hey everyone,

I’ve installed the Mapbox plugin, but the display doesn’t seem to be working properly. When I preview the app, the map sometimes appears, but most of the time it’s just a black screen — even though I haven’t changed any parameters between those occurrences.

Does anyone know what might be causing this?

Thanks in advance for any help!

#2

Hey @victor.bazire ,
Thank yo ufor contacting us.

I’m sorry to hear that you encountered a problem when using the plugin.
I checked how the plugin works on our demo page and found no such problem, the plugin works as it should.

Please configure the plugin as shown on our demo editor page and feel free to use the documentation.

Also, here are a few steps you can follow to troubleshoot this:

  1. Check your API key: Ensure that the Mapbox API key is correctly entered and active. If the key is invalid or has restrictions, it may cause the map not to load consistently.
  2. Check for Console Errors: Open the browser’s developer console (press F12 or right-click > Inspect > Console tab) while previewing the app. Look for any errors or warnings related to the Mapbox plugin. These could provide insights into what’s going wrong.
  3. Mapbox Style URL: Double-check the style URL for the map. If the style URL is incorrect or if the Mapbox server is having trouble retrieving it, the map might not load. You can try switching to a default style URL to see if the problem persists.
  4. Viewport Initialization: Sometimes, the map doesn’t load properly if the viewport or container dimensions aren’t set correctly. Make sure that the map container has a defined width and height in your app. A common issue is the map container having a 0px height or 0px width, which leads to a black screen.
  5. Plugin Version: Check that you’re using the latest version of the plugin. If not, try updating it and see if that resolves the issue.
  6. Network Issues: Ensure there are no network issues that could be preventing the map tiles from loading properly. This can happen if there are connectivity problems or if Mapbox’s servers are experiencing downtime.
  7. Mobile vs. Desktop: If you’re testing on a mobile device, make sure that the plugin is compatible with mobile browsers. There might be certain issues specific to mobile devices or emulators that cause the map to not render properly.

Please note that we provide general support for our plugins and do not offer consultancy or customization services.

If you’re looking for a team to assist with customization, you can consider hiring Zeroqode. By sharing your project details and budget, one of our project managers will get back to you with an estimate.

Have a nice day! :wink:

Best Regards,
Anton

Browse all Zeroqode Plugins for Bubble
Banner_Last3

#3

Hi @AntonZ,

I’m facing the same issue as @victor.bazire but just for some Custom Styles that I created in Mapbox. I checked all steps you provided for troubleshooting but nothing helped. However I found several Console Errors when loading the page/map as you can see attached. I’m not 100% sure but it could have something to do with POI-data I am using from Mapbox’s Street-v8 layer (a custom style without POI data was loading just fine). More specifically it seems to be related to the formatting of POI entries (e.g. the conditional coloring of Icons).

Also when using an HTML-Element iFrame, the map/style loads just fine, the plugin however returns a blank white screen.

Feel free to check out the style on your own (I made it public): mapbox://styles/giwdul97/cmkycxzhy003i01sdbvfwaxaw

Screenshot 2026-01-28 at 20.01.32
Screenshot 2026-01-28 at 20.01.321740×382 69.6 KB

It would be amazing if you could help me out!! Thanks in advance.

Best
Simon

1 Like
#5

Hey @simon3 ,
Thank you for contacting us.

We’ve reviewed the console output you provided and discussed this internally with our developer. Based on the errors shown, there’s no clear indication of an issue originating from the Mapbox plugin itself. The errors appear to be related to scripts or styling logic coming from the custom Mapbox style configuration rather than the plugin.

At the moment, we’re unable to fix or adjust user-created Mapbox styles on our side. The plugin expects a valid and supported Mapbox style object, and if something inside the style (for example, conditional icon formatting or POI rules) is not compatible, it may result in the blank map behavior you’re seeing.

As a next step, we recommend continuing to test by simplifying the custom style and re-introducing complexity step by step. If you’re able to reproduce a specific error that is clearly thrown by the plugin itself (rather than generic console or third-party script errors), please share it with us, we’ll be happy to investigate further and confirm whether there’s a genuine compatibility gap on the plugin side.

Thank you for understanding! :wink:

Best Regards,
Anton

Browse all Zeroqode Plugins for Bubble
Banner_Last3