Use the Labeling Summary report

The Labeling Summary report presents a general overview of the labeling classes in the map for quality assurance and performance checks. It identifies potential problems with labeling parameters that may impact labeling performance, map readability, and the ability to convert labels to annotation. The summary report lists all the layers in the map and all the label classes and their properties in each layer. Each layer has a minimum of one label class, whether or not it's currently being labeled. Layers that can't be labeled, such as layers referencing raster data, are not listed.

  1. To access the Labeling Summary report, on the Labeling tab, in the Map group, click More > Summary.
  2. Optionally, use the Search bar to search for a layer name, label class name, or a message from the Information reported chart below.
  3. Optionally, use the filter Filter to filter the messages.

    All

    All label classes regardless of labels being turned on or off.

    Labeled

    Label classes that are labeled.

    Unlabeled

    Label classes that are not labeled.

    Unlabeled Weighted

    Label classes that are not labeled. Features are still working as barriers to other labels due to a feature weight being set on the label class.

    All

    All label classes regardless of scale range.

    In scale range

    Label classes that are labeled at the present scale of the map.

  4. Optionally, click the Copy labeling summary button Copy Label Summary to copy the summary for use outside of ArcGIS Pro.

Information reported

The Labeling Summary report contains a listing for each layer that provides an overview of the main properties for your label class. Review information presented in red text, as it's reporting either an error that is preventing labels from being displayed or an issue that will cause decreased performance in your map labeling. The following items are checked and may be listed for each layer:

Information reportedPossible results

Is the label class turned on or off?

  • Labeled class.
    • The label class is checked.
  • Unlabeled class.
    • The label class is not checked, or it's checked and the layer is not visible.
  • Unlabeled class but still active due to feature weight. Features will be added to the placement engine as background features.
    • The label class is not checked, but the features from the label class are working as barriers to other labels being placed due to the feature weight set for the label class.

Is there an x,y offset applied to the symbol?

  • The text symbol has an XY Offset defined. This is not supported by the placement engine.
    • When placing labels, the placement engine uses the location of the text symbol before the x,y offset is applied. This may result in overlapping labels or white spaces on the map once the x,y offset is applied.

Is there an SQL query for the label class?

  • SQL Query defined. A subset of features will be added to the placement engine.
    • Yes, there is an SQL query present for this label class, and only features that satisfy the query will be labeled.
  • SQL Query not defined. All features will be added to the placement engine.
    • No, there is no SQL query, and all labels will be considered for placement.
  • Identical SQL Query found. Duplicate features will be generated. See [label class name].
    • The SQL query for this label class is a duplicate of the query for the referenced label class. This will result in features being labeled multiple times. If different attributes are being used to create the label, consider concatenating the fields into a label expression.

Is there a scale range set for the label class?

  • A scale range is set.
    • A scale range for the label class has been set, and the labels will be displayed between set scales only.

Are there duplicate label class names?

  • Duplicate class name. Class names should be unique within a layer.
    • Duplicate label class names exist within the same feature layer. It's recommended that you change one so that all names are unique.

Is there an advanced labeling expression set?

  • Advanced label expression defined.
    • There has been an advanced labeling expression created. This can be as simple as concatenating several fields into one label or more complicated and containing programming logic.
  • Label expression references a field that is not in the feature class. See [field name].
    • There is an error in the advanced labeling expression. Check the field name referenced in the error and change it to one that is present in the attributes of the feature layer.

Use the search box at the top of the Labeling Summary dialog box to filter the text shown in the report. For instance, search the name of a label class to see listings related to that label class only.

All label classes are shown by default, but you can click the Filter button Filter at the top of the Labeling Summary dialog box to limit the summary listing to show feature classes that are labeled, unlabeled, or unlabeled weighted or to limit the summary listing to just the label classes shown in the current scale range. You can use the Copy labeling summary button Copy Label Summary to copy the summary for use outside of ArcGIS Pro.


In this topic
  1. Information reported