Map labels disappear when following the instructions to change the language for ArcGIS Data Appliance 2026

Description

There is an error in the localization instructions in the data_appliance_open_vector_basemaps_help.pdf included in the My Esri download for ArcGIS Data Appliance 2026: Open Vector Basemaps. 

Solution or Workaround

Localization changes the labels on the map for a select number of mainly small-scale features when the data supports it.

Localize the map by changing the "text-field" value of the map style's resources\styles\root.json file. Use the corresponding codes for the language you want to display.

The correct way to change the language for map labels in Open Vector Basemaps is to change the default JSON labels from "{_name}" to the localized language "{_name_XX}" where XX is the language name, for example, "{_name_FR}" for French.

For complete instructions and a list of supported languages, see Features supported for localization in the Localize Open Vector Basemaps styles topic of the Open Vector Basemaps Help website or the updated ArcGIS Data Appliance 2026: Open Vector Basemaps help PDF included in the Additional resources for Open Vector Basemaps topic.

The following JSON snippet shows an example of a feature in which to make this change.

  }, {
			"id" : "coastal water area/label/sea",
			"type" : "symbol",
			"source" : "esri-open",
			"source-layer" : "coastal water area/label",
            "filter" : ["==", "_label_class", 2],
			"minzoom" : 2,
			"layout" : {
				"text-font" : ["Arial Unicode MS Regular"],
				"text-size" : {
					"stops" : [[2, 10], [7, 11], [8, 12], [12, 13], [16, 14]]
				},
                "text-max-width" : {
					"stops" : [[2, 5], [7, 6], [8, 7], [12, 8], [16, 9]]
				},
                "text-line-height" : {
					"stops" : [[7, 1], [8, 1.13], [12, 1.16], [16, 1.2]]
                },
				"text-field" : "{_name}",
				"text-optional" : true
			},