To see the latest known issues with cloud-based maps styling, see
the release notes.
Messages
Here are some messages you might see and their solutions:
A map styles property cannot be set when a mapId is present.
You cannot use map IDs and styles at the same time. Instead, edit the style
associated with the map ID using the Cloud console. See also
I get an error trying to load my map style.
The style editor can't be loaded right now
The preview map uses a vector map. In cases when vector maps cannot
be loaded on your web browser, it falls back to a "no map" experience:
If you run into this issue, try the following:
Check your browser settings to make sure hardware acceleration is enabled.
Check if your device is supported by visiting
get.webgl.org. If the demo does not
run, your browser or device may not be compatible with WebGL. Make sure your
device's drivers/browser combination is not subject to the denylist rules
defined in the Khronos WebGL wiki.
Update your graphics card and make sure that your device has a video
graphics card (GPU) that supports WebGL. See Application and website
requirements.
You might see the following messages displayed after creating or updating
a style.
My style changes aren't updating in my apps or website
Style changes can take a few hours to propagate to your apps and websites, and
apps can take longer if the devices aren't connected to the internet. If you're
still not seeing your style changes after a few hours, check the following
things:
Make sure you've published your style update.
If you made your changes in a duplicated style, make sure you've associated
your map ID with the duplicated style. For details, see
Associate or remove map IDs on your style.
I can't see my style changes on the preview map
If you make a change, and can't see the change on the preview map, here
are some things to try.
Check for style inheritance overrides: Check to see if there is a
custom child style underneath the style you're setting that is overriding
its parent style. For details on style inheritance, see
Understand map style inheritance and hierarchy.
Change the map zoom level: It's possible that the map features you are
styling are not visible in the map at the current zoom level.
Zoom in: If you are sure the feature is present on the map,
zoom in to a more detailed view and it may appear.
Zoom out: With some large map features, you may need to zoom out
until the detailed map features drop out before your styling shows up.
My text looks blurry or out of focus
If the colors you've chosen for your fill and stroke for text don't have
enough contrast, the font looks bold and fuzzy because the stroke (outline)
and fill merge together. Select colors that have enough contrast.
My style looks dull or the wrong color
The map feature you are styling may overlap with one or more other map
features. For assistance, see Manage styles that overlap.
The wrong map features are being styled
If you are seeing map features that match the style you've set, it may be that
the default map style for those map features are the same as the style you're
setting. Here are some things to try:
Turn off visibility for the map feature that matches. For example,
if you are trying to set Winery to a dark red, and notice that Emergency
POIs are red, which could be confusing for your users. You can choose to
turn off visibility for Emergency POIs to avoid this confusion.
Change the style of the map features that you don't want to match.
the example above, you could also choose to style Emergency POIs to orange
to avoid confusion.
I get an error trying to load my map style
You cannot use map IDs and styles at the same time. You can do one of the
following:
Recommended: Remove the map style, and edit the style associated with
the map ID using the Cloud console. With this method, you can create one
style that applies to all platforms. For details, see
Associate a style with a map ID.
Remove the map ID, and edit the style for each app platform using
Add a styled map.
Since JSON styling is platform-specific, you need to create the style for each
app platform on which you display the styled maps.
If you already have a JSON map style that you want to use for cloud-based
maps styling, you can import it. For details, see
Import a JSON map style.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 UTC."],[[["\u003cp\u003eThis troubleshooting guide addresses common issues encountered when using cloud-based map styling in Google Maps Platform.\u003c/p\u003e\n"],["\u003cp\u003eSolutions are provided for problems related to style updates, preview map display, text clarity, color accuracy, and unintended feature styling.\u003c/p\u003e\n"],["\u003cp\u003eLegacy cloud styling access is limited to projects that previously opted out and still have legacy styles.\u003c/p\u003e\n"],["\u003cp\u003eThe latest known issues and release notes for cloud-based map styling are available in separate documentation.\u003c/p\u003e\n"],["\u003cp\u003eUsers can report bugs and feature requests through provided links to Google's issue tracker.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot\n\nSelect platform: [Android](/maps/documentation/android-sdk/cloud-customization/troubleshoot \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/cloud-customization/troubleshoot \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/cloud-customization/troubleshoot \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/maps-static/cloud-customization/troubleshoot \"View this page for the Web Service platform docs.\")\n\n\u003cbr /\u003e\n\n| To use cloud-based maps styling on Android, you must use the latest renderer for Maps SDK for Android. [Follow these instructions](/maps/documentation/android-sdk/renderer).\n\nThis document describes common issues that might occur when setting up your\nmap style, and how to resolve them.\n\nClick to file a\n[Bug](https://issuetracker.google.com/issues/new?component=1415514&template=1863115)\nor [Feature Request](https://issuetracker.google.com/issues/new?component=1415514&template=1863479).\n\nKnown issues\n------------\n\nTo see the latest known issues with cloud-based maps styling, see\nthe [release notes](../cbms-release-notes).\n\nMessages\n--------\n\nHere are some messages you might see and their solutions:\n\n\u003cbr /\u003e\n\nA map `styles` property cannot be set when a `mapId` is present. You cannot use map IDs and styles at the same time. Instead, edit the style associated with the map ID using the Cloud console. See also [I get an error trying to load my map style](#mapid-w-style).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThe style editor can't be loaded right now The preview map uses a vector map. In cases when vector maps cannot\nbe loaded on your web browser, it falls back to a \"no map\" experience:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nIf you run into this issue, try the following:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n- Check your browser settings to make sure hardware acceleration is enabled.\n- Check if your device is supported by visiting [get.webgl.org](https://get.webgl.org/). If the demo does not run, your browser or device may not be compatible with WebGL. Make sure your device's drivers/browser combination is not subject to the denylist rules defined in the [Khronos WebGL wiki](https://www.khronos.org/webgl/wiki/BlacklistsAndWhitelists).\n- Update your graphics card and make sure that your device has a video graphics card (GPU) that supports WebGL. See [Application and website\n requirements](/maps/documentation/android-sdk/cloud-customization/setup#reqs).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nFor additional support, see [GMP WebGL support](/maps/documentation/javascript/webgl/support).\n\n\u003cbr /\u003e\n\nStyle issues\n------------\n\nYou might see the following messages displayed after creating or updating\na style.\n\n### My style changes aren't updating in my apps or website\n\nStyle changes can take a few hours to propagate to your apps and websites, and\napps can take longer if the devices aren't connected to the internet. If you're\nstill not seeing your style changes after a few hours, check the following\nthings:\n\n- Make sure you've published your style update.\n\n- If you made your changes in a duplicated style, make sure you've associated\n your map ID with the duplicated style. For details, see\n [Associate or remove map IDs on your style](/maps/documentation/android-sdk/cloud-customization/map-styles#associate-style-with-map-id).\n\n### I can't see my style changes on the preview map\n\nIf you make a change, and can't see the change on the preview map, here\nare some things to try.\n\n- **Check for style overlaps** : For details, see\n [Manage styles that overlap](/maps/documentation/android-sdk/cloud-customization/overlap).\n\n- **Check for style inheritance overrides** : Check to see if there is a\n custom child style underneath the style you're setting that is overriding\n its parent style. For details on style inheritance, see\n [Understand map style inheritance and hierarchy](/maps/documentation/android-sdk/cloud-customization/map-hier).\n\n- **Change the map zoom level**: It's possible that the map features you are\n styling are not visible in the map at the current zoom level.\n\n - **Zoom in**: If you are sure the feature is present on the map,\n zoom in to a more detailed view and it may appear.\n\n - **Zoom out**: With some large map features, you may need to zoom out\n until the detailed map features drop out before your styling shows up.\n\n### My text looks blurry or out of focus\n\nIf the colors you've chosen for your fill and stroke for text don't have\nenough contrast, the font looks bold and fuzzy because the stroke (outline)\nand fill merge together. Select colors that have enough contrast.\n\n### My style looks dull or the wrong color\n\nThe map feature you are styling may overlap with one or more other map\nfeatures. For assistance, see [Manage styles that overlap](/maps/documentation/android-sdk/cloud-customization/overlap).\n\n### The wrong map features are being styled\n\nIf you are seeing map features that match the style you've set, it may be that\nthe default map style for those map features are the same as the style you're\nsetting. Here are some things to try:\n\n- **Turn off visibility for the map feature that matches**. For example,\n if you are trying to set Winery to a dark red, and notice that Emergency\n POIs are red, which could be confusing for your users. You can choose to\n turn off visibility for Emergency POIs to avoid this confusion.\n\n- **Change the style of the map features that you don't want to match**.\n the example above, you could also choose to style Emergency POIs to orange\n to avoid confusion.\n\n### I get an error trying to load my map style\n\nYou cannot use map IDs and styles at the same time. You can do one of the\nfollowing:\n\n- **Recommended** : Remove the map style, and edit the style associated with\n the map ID using the Cloud console. With this method, you can create one\n style that applies to all platforms. For details, see\n [Associate a style with a map ID](/maps/documentation/android-sdk/cloud-customization/map-styles#associate-style-with-map-id).\n\n- Remove the map ID, and edit the style for each app platform using\n\n [Add a styled map](../styling).\n\n Since JSON styling is platform-specific, you need to create the style for each\n app platform on which you display the styled maps.\n\nIf you already have a JSON map style that you want to use for cloud-based\nmaps styling, you can import it. For details, see\n[Import a JSON map style](/maps/documentation/android-sdk/cloud-customization/map-styles#json-import)."]]