A map style is a set of visual customizations to map features
that you associate with a map ID. You then reference the
map ID in your application code to display the customized map.
You can create a map style before you have a map ID; however, to use
the style, you must associate the style with a map ID. To use a map style,
you must take all of these steps:
In the Google Cloud console,
go to Map Styles, and select a project, if needed.
In Map styles, click Create style.
In the dialog, under the Google styles tab, select one of the following:
Light to create a light map style, where the map type is roadmap.
scienceDark to create a dark map style, where the map type is roadmap dark.
(Optional) To apply the monochrome variation to your map style, select Monochrome.
Select Customize to create a new untitled style.
Select map features and change their style to create the map style you want.
Map features with custom styles have a solid blue dot next to them. If you
customize a child style, the parent style displays a blue circle. For more
information on map style hierarchy, see
Understand map style inheritance and hierarchy.
Click Save.
In the Save and publish map style box, enter a name for your style and
optionally a description, and click Save.
The style is automatically published, and you see your new style's
main page.
Duplicate a style
Go to Map Styles, and select a project, if needed.
Select one of your existing styles.
On the style page, click Duplicate.
In the Duplicate Map Style box, enter a new map name and optionally
a description.
Click Save.
The style is automatically published, and you can see your new style's
main page. Associate it with a map ID to use it for your maps. For details,
see Associate a map ID to a map style.
If you want to modify the style, click Customize, make changes,
and click Save.
Publish a style
When you first create a new map style, that first instance of
the new map style is automatically published. After that, you save changes
as a draft and when you're happy with the changes, you must publish.
Make the changes to the map style or duplicated map style. For details, see
Change a style.
Click Save to save changes as a draft.
When you're ready to publish and have your changes go live for any map IDs
using that map style, click Publish.
Published versus Draft map styles
Published: A published map style is live. Any maps that use the map style
display the published version of it.
Draft: Draft versions of a map style are works in progress
and aren't displayed in maps until you publish them.
Change a style
If you want to make changes to your map style, you can make the changes right
in the style editor. You have a couple of choices when you update a style:
If you want changes to go live as soon as you're ready: Click
Customize and make your changes. Click Save to save your
changes as a draft, and then click Publish when you are ready.
If you want to test your changes in a test environment first: Instead of
making changes directly in the map style, duplicate the style first. For
details, see Duplicate a style and
Test map style updates.
Once you've created a map style, you can make changes to it on the style's
main page in any of the following ways:
When you link a light map style that has data-driven styling or datasets enabled
to a map ID, the enabled layers are also available for
the science dark map style.
To use data-driven styling or datasets with a science dark map style,
you must do the following in the Google Cloud console:
Go to Map Styles and either select a light map style or
create one.
In the style main page, enable the your choice of layers on a light map
style.
Associate your style to a map ID to display your custom style on your website
and in your app. A map ID can have only one light style (roadmap type) and one
science dark style (roadmap dark type) associated with it.
To change the associated style for a map ID, do the following in the
Google Cloud console:
Go to Map Management and select a map ID.
In the Map styles section, click Change style for a light or dark map style.
The panel displays only styles with a roadmap map type for light styles, and
only styles with a science roadmap dark map type for dark styles.
In the panel, select one of the styles to associate to this map ID.
You navigate on the preview map in the same way you navigate on any Google map:
Enter an address or location in the Search Address box.
Click the compass to center on your location. You may also have to grant
location permissions.
Drag to move the map.
Zoom in or out using the plus (+) and minus (-).
Find map features
To find a map feature that you want to style, you can use the filter or the map
inspector.
You can also expand and collapse map feature categories to find the map
feature you want. Browse the list of map features at What you can style on a map.
Filter map features
To find map features using the filter, under Map Features, enter a
term in the Filter box.
If you can't find a map feature:
Don't use plurals. All of the categories are singular.
Try using a more generic term for the feature. For example, instead of
"pizza parlor" or "fast food," search for "restaurant."
Try using a broader category, and then explore that category for the closest
map feature. For example, instead of "theater," search for "entertainment."
Inspect map features
To find map features using the map inspector, perform the following steps:
Left-click anywhere on the map to open the map inspector at your click point.
Select a map feature in the map inspector to open it in the Map Features pane.
[[["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-28 UTC."],[[["\u003cp\u003eA map style is a customizable set of visual elements applied to a map using a map ID, which is referenced in your application code.\u003c/p\u003e\n"],["\u003cp\u003eYou can create a map style by starting fresh, duplicating an existing style/version, or importing JSON styling code.\u003c/p\u003e\n"],["\u003cp\u003eMap styles exist as either draft or published versions, with published versions actively displayed on maps using the associated map ID.\u003c/p\u003e\n"],["\u003cp\u003eOnce a map style is created, you can further customize its appearance, manage version history, associate it with map IDs, and perform other actions like renaming, duplicating, or deleting it.\u003c/p\u003e\n"],["\u003cp\u003eStyles can be associated with multiple map IDs for use across various Google Maps applications, but each map ID can only be linked to one style at a time.\u003c/p\u003e\n"]]],["Map styles are customized sets for map IDs, with published styles being live and draft styles being in progress. Creating a new style can be done by starting from scratch, duplicating an existing style or version, or importing JSON. Styles can be managed by editing, renaming, duplicating, or deleting. Version history allows for restoring previous styles. Map IDs must be associated with a style to display it in apps, with one map ID linked to one style. Association and removal of map IDs can be managed.\n"],null,["Select platform: [Android](/maps/documentation/android-sdk/cloud-customization/map-styles \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/cloud-customization/map-styles \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/cloud-customization/map-styles \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/maps-static/cloud-customization/map-styles \"View this page for the Web Service platform docs.\")\n\n\u003cbr /\u003e\n\nA map style is a set of visual customizations to map features\nthat you associate with a map ID. You then reference the\nmap ID in your application code to display the customized map.\n\nYou can create a map style before you have a map ID; however, to use\nthe style, you must associate the style with a map ID. To use a map style,\nyou must take all of these steps:\n\n1. **Create and publish a map Style** . For details, see\n [Create a style](#create-style) and [Publish a style](#publish-style).\n\n2. **Create a map ID** . For details, see\n [Create a map ID](../map-ids/get-map-id).\n\n3. **Associate the map style with a map ID** . For details, see\n [Associate a map ID to a map style](#associate-style-with-map-id).\n\n4. **Add the map ID to your app** to display your style. For details, see\n [Add the map ID to your map](../map-ids/get-map-id#add-a-map-id-to-your-app).\n\n| **Tip**: Once the map ID is in your application code, you can change the map style without any changes in your application code, and your end users don't have to upgrade to see updated map styles. Instead, you edit the map style associated with the map ID, and changes show up in your application maps.\n\nThis document describes how to create, edit, and publish map styles and how to\nassociate them to a map ID.\n\nCreate a map style\n\nCreate a map style using one of these methods:\n\n- [Create](#create-new-style) a new style using the default Google map style.\n\n- [Duplicate](#duplicate-style) and modify an existing standard or customized style.\n\n- [Import a JSON map style](/maps/documentation/javascript/cloud-customization/json#json-import) to use as a customized style.\n\nCreate a new style [Experimental](/maps/launch-stages#experimental) feature.\n\n1. In the Google Cloud console,\n go to [**Map Styles**](https://console.cloud.google.com/google/maps-apis/studio/styles), and select a project, if needed.\n\n2. In **Map styles** , click **Create style**.\n\n3. In the dialog, under the **Google styles** tab, select one of the following:\n\n - **Light** to create a light map style, where the map type is roadmap.\n - science **Dark** to create a dark map style, where the map type is roadmap dark.\n4. (Optional) To apply the monochrome variation to your map style, select **Monochrome**.\n\n5. Select **Customize** to create a new untitled style.\n\n6. Select map features and change their style to create the map style you want.\n\n Map features with custom styles have a solid blue dot next to them. If you\n customize a child style, the parent style displays a blue circle. For more\n information on map style hierarchy, see\n [Understand map style inheritance and hierarchy](/maps/documentation/javascript/cloud-customization/map-hier).\n | **Note:** Not all styles appear at all zoom levels. For more information, see [Style zoom levels](/maps/documentation/javascript/cloud-customization/zoom-levels).\n7. Click **Save**.\n\n8. In the **Save and publish map style** box, enter a name for your style and\n optionally a description, and click **Save**.\n\nThe style is automatically published, and you see your new style's\nmain page.\n| **Caution:** Making style changes but not explicitly saving them creates **Unsaved Changes** in your map style's version history. These versions are lost when you close the browser tab or when your Cloud console session ends.\n\nDuplicate a style\n\n1. Go to [**Map Styles**](https://console.cloud.google.com/google/maps-apis/studio/styles), and select a project, if needed.\n\n2. Select one of your existing styles.\n\n3. On the style page, click **Duplicate**.\n\n4. In the **Duplicate Map Style** box, enter a new map name and optionally\n a description.\n\n5. Click **Save**.\n\n The style is automatically published, and you can see your new style's\n main page. Associate it with a map ID to use it for your maps. For details,\n see [Associate a map ID to a map style](#associate-style-with-map-id).\n6. If you want to modify the style, click **Customize** , make changes,\n and click **Save**.\n\nPublish a style\n\nWhen you first create a new map style, that first instance of\nthe new map style is automatically published. After that, you save changes\nas a draft and when you're happy with the changes, you must publish.\n\n1. Make the changes to the map style or duplicated map style. For details, see\n [Change a style](#update-style).\n\n2. Click **Save** to save changes as a draft.\n\n3. When you're ready to publish and have your changes go live for any map IDs\n using that map style, click **Publish**.\n\nPublished versus Draft map styles\n\n**Published**: A published map style is live. Any maps that use the map style\ndisplay the published version of it.\n| **Note:** Style changes can take a few hours to propagate to your apps 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, see [My style changes aren't updating](/maps/documentation/javascript/cloud-customization/troubleshoot#style-delay).\n\n**Draft**: Draft versions of a map style are works in progress\nand aren't displayed in maps until you publish them.\n\nChange a style\n\nIf you want to make changes to your map style, you can make the changes right\nin the style editor. You have a couple of choices when you update a style:\n\n- **If you want changes to go live as soon as you're ready** : Click\n **Customize** and make your changes. Click **Save** to save your\n changes as a draft, and then click **Publish** when you are ready.\n\n- **If you want to test your changes in a test environment first** : Instead of\n making changes directly in the map style, duplicate the style first. For\n details, see [Duplicate a style](#duplicate-style) and\n [Test map style updates](/maps/documentation/javascript/cloud-customization/test-style-updates).\n\nOnce you've created a map style, you can make changes to it on the style's\nmain page in any of the following ways:\n\n- **Edit** : Click **Customize**.\n\n- **Duplicate** : For details, see\n [Duplicate a style](/maps/documentation/javascript/cloud-customization/map-styles#duplicate-style).\n\n- **Rename**: Rename the map style.\n\n- **Delete**: Delete the map style.\n\nUse data-driven styling and datasets [Experimental](/maps/launch-stages#experimental) feature.\n\nIn the style's main page, you can enable and view layers for\n[data-driven styling for boundaries](../dds-boundaries/overview) and\n[data-driven styling for datasets](../dds-datasets/overview) on light map styles.\n\nWhen you link a light map style that has data-driven styling or datasets enabled\nto a [map ID](../map-ids/mapid-over), the enabled layers are also available for\nthe science dark map style.\n\nTo use data-driven styling or datasets with a science dark map style,\nyou must do the following in the Google Cloud console:\n\n1. Go to **Map Styles** and either select a light map style or\n [create one](#create-style).\n\n2. In the style main page, enable the your choice of layers on a light map\n style.\n\n3. [Associate the light map style to the same map\n ID](#associate-style-with-map-id) as the dark map style.\n\nAssociate your style to a map ID [Experimental](/maps/launch-stages#experimental) feature.\n\nAssociate your style to a map ID to display your custom style on your website\nand in your app. A map ID can have only one light style (roadmap type) and one\nscience dark style (roadmap dark type) associated with it.\n\nTo change the associated style for a map ID, do the following in the\nGoogle Cloud console:\n\n1. Go to **Map Management** and select a map ID.\n\n2. In the Map styles section, click **Change style** for a light or dark map style.\n\n The panel displays only styles with a roadmap map type for light styles, and\n only styles with a science roadmap dark map type for dark styles.\n3. In the panel, select one of the styles to associate to this map ID.\n\n4. Click **Done**.\n\n5. Click **Save** to apply all changes.\n\nTo use your cloud-based map style,\n[add the map ID to your app](../map-ids/get-map-id#add-a-map-id-to-your-app).\n\nNavigate on the preview map\n\nYou navigate on the preview map in the same way you navigate on any Google map:\n\n- Enter an address or location in the **Search Address** box.\n\n- Click the compass to center on your location. You may also have to grant\n location permissions.\n\n- Drag to move the map.\n\n- Zoom in or out using the plus (+) and minus (-).\n\nFind map features\n\nTo find a map feature that you want to style, you can use the filter or the map\ninspector.\n\nYou can also expand and collapse map feature categories to find the map\nfeature you want. Browse the list of map features at [What you can style on a map](/maps/documentation/javascript/cloud-customization/taxonomy).\n\nFilter map features\n\nTo find map features using the filter, under **Map Features** , enter a\nterm in the **Filter** box.\n\nIf you can't find a map feature:\n\n- Don't use plurals. All of the categories are singular.\n\n- Try using a more generic term for the feature. For example, instead of\n \"pizza parlor\" or \"fast food,\" search for \"restaurant.\"\n\n- Try using a broader category, and then explore that category for the closest\n map feature. For example, instead of \"theater,\" search for \"entertainment.\"\n\nInspect map features\n\nTo find map features using the map inspector, perform the following steps:\n\n1. Left-click anywhere on the map to open the map inspector at your click point.\n\n2. Select a map feature in the map inspector to open it in the **Map Features** pane."]]