Work with map style versions

Select platform: Android iOS JavaScript Web Service

Note: Version history is only available for map styles created on August 2, 2022 or later.

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.

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.

Important: When you Publish any map style associated with one or more map IDs, that style's latest published changes are visible in all apps using map IDs associated with that map style. Until your style changes are complete, Save rather than Publish your style changes.

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.

Note: A duplicated style does not retain the versions of the style it duplicated.

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.

   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.

Note: If the restored version is exactly the same as the published version, you can't publish the restored version. If you still want to publish the draft of the restored version, even if it's identical to the published version, you must modify the style in some way, then select Save and then Publish.