Test style updates

  • Before updating a production map style, it's recommended to test changes in a duplicated style to ensure they appear as expected.

  • The testing process involves duplicating the style, making and publishing changes, associating it with a staging environment map ID for testing, and finally associating it with the production map ID once satisfied.

  • Duplicated styles don't inherit version history from the original, requiring manual updates to the original style if history preservation is desired.

  • Style changes might need a few hours to reflect across platforms, with potential delays for offline devices.

When you want to update a style that is being used in production, youmay want to test your style updates first.

  1. Make a copy of the production map style.

  2. In the copied map style, make your changes and publish.

    If the copied style has just been updated, check the updatedstyles to make sure they look as expected. Map features with custom styleshave a solid blue dot next to them. Expand all map features to find allchanges.

  3. Associate the copied map style with a different map ID that you can useto test the style in your staging environment.

  4. Test your style changes in your staging environment.

  5. When you are happy with the results, associate the copied map stylewith your production map ID.

Note: A copied map style does not retain the versions of the styleit copied. If you want to maintain the style history, you can insteadtake your tested changes from the copied map style and make them to theoriginal map style.Note: Style changes can take a few hours to propagate to your appswebsites, and apps can take longer if the devices aren't connected tothe internet. If you're still not seeing your style changes after afew hours, seeMy style changes aren't updating.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-21 UTC.