The web map’s label styles are not retained in ArcGIS Web AppBuilder

Description

Labeling a web map’s features or clustered features is useful to describe the features of a layer and helps the audience understand the features better. However, when a web map’s labels are configured in Map Viewer and viewed in ArcGIS Web AppBuilder, certain labels are not displayed or label styles are not retained, as shown in the image below.

Cause

The label styles configured in Map Viewer are incompatible with ArcGIS Web AppBuilder as Map Viewer uses ArcGIS API for JavaScript 4.x while ArcGIS Web AppBuilder uses ArcGIS API for JavaScript 3.x. Multiline labels, clustering labels, and certain label styles are not supported in ArcGIS API for JavaScript 3.x. Refer to Esri Community: Apps that use ArcGIS API for JavaScript 3.x vs 4.x for more information.

Solution or Workaround

Use one of the following options to preserve the web map’s label styles in ArcGIS Web AppBuilder or ArcGIS Online web apps that use ArcGIS API for JavaScript 4.x.

Configure the labels in Map Viewer Classic

To ensure label styles are retained and compatible with ArcGIS Web AppBuilder, configure the web map’s labels in Map Viewer Classic as it uses ArcGIS API for JavaScript 3.x. However, multiline labels, clustering labels, and certain label effects are not supported in Map Viewer Classic. Refer to ArcGIS Online: Labeling considerations and ArcGIS Online: Considerations for more information.

Use compatible ArcGIS Online web apps to retain the web map’s label styles

Create ArcGIS Online web apps that support label styles configured in Map Viewer, such as ArcGIS Experience Builder, ArcGIS Dashboards, and ArcGIS StoryMaps. Refer to ArcGIS Online: Create apps from maps for more information.