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.

Information reported

The Labeling Summary report contains a listing for each layer that provides an overview of the main properties for a label class. 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.

Which font is used? Is it available?

  • Font: [Font Name]; [Font Type]
  • Font unavailable: [Font Name]; [Font Type]
    • The font referenced is unavailable. You will need to install the font.

Is there an error with an entered label parameter value?

  • A message describing the value conflict will display. It will be linked to the documentation for that parameter.
    • Navigate to the parameter listed by following the steps in the documentation. The parameter with the error will be outlined in red.

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 within scale range, to limit the summary listing to just the label classes shown in the current scale range. You can also use the Issues Warning drop-down menu to further filter the label classes based on issues. You can use the Copy labeling summary button Copy Label Summary to copy the summary for use outside of ArcGIS Pro.

  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 which label classes are shown.

    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.

    In scale range

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

  4. Optionally, use the Issues Warning drop-down menu to further filter the issues.

    All

    All label classes regardless of potential issues.

    Errors

    Label classes that contain an issue that is preventing labels from being displayed.

    Warnings

    Label classes that contain an issue that will cause decreased performance in map labeling.

    Value conflicts

    Label classes that contain an incorrect value in a label class parameter.

    Unavailable Fonts

    Label classes that use a font that is not installed.

    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.

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

In this topic
  1. Information reported