Work with map style versions

Select platform: Android iOS JavaScript Web Service

When make and save changes to a map style, those changes become saved versions that you can view, restore, or duplicate. To see a style's versions, select Version History.

A screenshot of the Maps Styles' Versions pane in the Google Cloud Console. The Save and Publish buttons are above the pane, the version-specific Restore and Duplicate buttons are at the bottom of the Version History pane, and several Draft and Published versions are listed.

To view all versions of a map style:

  1. Go to Map Styles, and select a project, if needed.
  2. Select an existing map style.
  3. Select Customize Style.
  4. Select Version History.

Version history is divided into different types:

  • As Drafts
    • Selecting Save creates new dated versions. Saved drafts are not usable in your apps until they are explicitly published.
    • Changes you make without saving create an Unsaved changes draft that are lost if you close your browser window or end your session.
  • As Published Versions
    • When you create a new map style, duplicate an existing style, or import a JSON style, it is published automatically.
    • Selecting Publish creates new dated versions that are available for use in your apps. The most recent published version is applied to any apps with the associated map IDs.

You can view any previous version in Version History. To reuse a version and make changes to it, you must either Restore the version, which sets that version to be the current, active version of the map style, or Duplicate it, which creates a new, separate map style based on that version.

If you have unsaved changes when you restore any version, those unsaved changes automatically become a new dated draft version.

Duplicate a map style version

  1. Go to Map Styles, and select a project, if needed.
  2. Select one of your existing styles, and click Customize Style.
  3. Select Version History.
  4. Select a style version, and then at the bottom of the Version History pane, select Duplicate.
  5. The style is duplicated with "Copy of" added to the style name.

The duplicated style is automatically published and you get a link to open the new style in a new tab.

Restore a map style version

If you want to use a previous version of a map style, you can restore it. For example, if you created a branded map style to support a special event, when the event is finished you can restore the standard version of the map style.

  1. Go to Map Styles, and select a project, if needed.

  2. Select the style you want, and select Customize Style.

  3. Select Version History.

  4. Select the version you want to restore, and at the bottom of the Version History pane, select Restore. The restored style becomes the most recent draft of the style.

  5. Close the Version History pane, and select Publish.