Update a map style to the latest version

Select platform: Android iOS JavaScript Web Service

If you have map styles created in an earlier version of cloud-based maps styling, you can update them to the new styling. The new map styling has more map features and performance improvements, along with an updated hierarchy that requires you to update and check your legacy styles.

You don't have to update earlier styles to the latest release. Your existing styles still work. However, if you want to use the improvements in the latest release, you have to update or recreate your legacy styles.

You can identify legacy map styles by going to Map styles and looking for "Legacy" on the map tile.

Legacy tag on a map style tile

For information on what has changed in the new styling, see Map feature changes.

Before you begin

Here's what happens when you update a legacy map style:

  • The map style is duplicated: The styles in the legacy map style are mapped to the new map feature hierarchy, and saved as a new map style.

  • Your legacy map style is untouched: It continues to work for map IDs to which it is assigned.

  • No map ID: The updated duplicate map style does not have any map IDs associated with it by default.

Differences from the legacy release

The latest release doesn't support the following features:

  • Android does not support Data-driven styling (DDS).

  • Create new styles from uploaded JSON styles. For a workaround, see Import JSON styles.

  • Industry-optimized and Google style templates. All new styles now start from the base map style.

Update a legacy map style

You can update a legacy map style to the new map styling without affecting the old style.

  1. Open a legacy map style.

  2. At the top, select Update to latest version to do the following:

    • Duplicate your legacy map style into a new map style.
    • Update your legacy map styles with the new map styles.
    • Leave the map ID associated with the legacy style.
  3. When the update is complete, open the duplicated map style, and check that it works as expected. For more information, see Check an updated legacy map style.

  4. When you are satisfied that the updated style is correct, replace the legacy style. For details, see Replace a legacy style.

Check an updated legacy map style

Use new map IDs to check your updated legacy map style.

  1. In the style editor, open the updated map style that was duplicated from your original.

  2. Map features that have custom styles are marked with a solid blue dot. Expand all map features to find all of the changes.

    Blue dot indicating a custom style

  3. Check all map features with custom styles in the following areas:

    • Map features: Check that the legacy map features have been moved to the appropriate new map features.

    • Map styling: Check that colors, visibility, and other styling features are rendering as expected on the preview map.

    • Take advantage of the new map features: Look to see if there is a new map feature that is more accurate or detailed that works for your needs.

  4. Create new map IDs for each platform you use the map style on, and associate them with the updated map style.

  5. Reference the new map IDs in your test environments, and check that the maps are rendering correctly on all platforms that use the legacy map style.

  6. Make any needed adjustments to the updated map style, and test the adjustments.

  7. When you are satisfied with the updated map style, replace the legacy style. For details, see Replace a legacy style.

Replace a legacy style

After you have updated a legacy map style and checked it, you can replace the legacy style with the updated map style.

  1. Publish the updated map style.
  2. Go to the legacy map style and note what map IDs it is associated with.
  3. Associate the updated map style with the original map IDs for each platform.

Import a JSON map style

Importing a JSON map style is not supported in the latest cloud styling. A workaround is to import the JSON style into the legacy style editor, and then update it.

  1. In the style editor, select Create style, and then select Opt Out to open the legacy style editor.

  2. Follow the instructions in Import JSON styling to create a legacy map style.

  3. Update the imported JSON map style. For details, see Update a legacy map style.