Graduated color symbology is used to show a quantitative difference between mapped features by varying the color of symbols. Data is classified into ranges that are each assigned a different color from a color scheme to represent the range. For instance, if your classification scheme has five classes, five different symbol colors are assigned. The size of the symbols stays the same. Maps that vary in color this way are usually called choropleth maps. Typically, you choose a continuous color scheme to apply different shades of the same color so that lighter shades match lower data values and darker shades match higher data values.
Symbol color is an effective way to represent differences in magnitude of a phenomenon because you can distinguish variations in color if there are relatively few classes. A range of seven colors is the approximate upper limit of colors that can be clearly distinguished on a map. Avoid using too many classes, especially if you are using light colors. Although symbol color is applied from a color scheme, you can modify the color of each symbol class. This means you can design a custom set of colors that have sufficient variation to make them distinguishable from one another.
When classifying data, your data may vary around a specific value that is important to maintain, such as a median value or any other significant threshold. For instance, data showing positive and negative change may vary around a value of 0. Rather than use a continuous color scheme with a midrange color applied to the values near 0, you want to clearly highlight that 0 is an inflection point in the data distribution. You can do this by adding a critical break to that symbol class and then applying a diverging color scheme. This forces the upper end of one class and the lower end of the next class to use the critical break value.
Graduated color symbology can be based on an attribute field in the dataset, or you can write an Arcade expression to generate numeric values on which to symbolize.
The Primary symbology tab 
has three subtabs to establish graduated color symbology:
- The Classes tab is where you manage symbols, manually assign values to classes, create descriptive labels, and group the symbol classes.
- The Histogram tab is where you view and edit the data ranges of the symbol classes. See Histograms for more information.
- The Scales tab is where you specify the scale ranges in which each symbol class draws.
- Select a feature layer in the Contents pane. On the ribbon, on the Feature Layer tab, in the Drawing group, click Symbology and click Graduated Colors to open the Symbology pane.
- In the Symbology pane, on the Primary symbology tab , choose the numeric field for the data to be mapped.
- Optionally, click the expression button
to open the Expression Builder dialog box. Write an expression and click Verify 
to validate it.Note that although an expression is valid, it may not return a valid numeric value. You can use the filter button
on the Expression Builder dialog box to show only numeric fields to help prevent this. - To normalize the data, choose a field from the Normalization menu. Choose percentage of total to divide the data value to create ratios, or choose log to symbolize on the logarithm of each value.
This can be an effective way to generate a smaller range of values if the dataset includes significant outliers. Normalization is available only when the graduated color symbology is based on a field. If it is symbolized on an expression, the Normalization field is disabled.
- Classify the data using an appropriate classification method and number of classes.
- Choose a color scheme.
The classification method and number of classes in the layer dictate which color schemes from core styles appear in the list. For example, if you classify your data by standard deviation, diverging color schemes are available. If you show five classes, only continuous color schemes and color schemes with five classes are shown. Color schemes stored in your Favorites style or custom styles always appear in this list, regardless of their type or number of colors.
Note:
The colors in the color scheme are applied to all symbol classes by default. To apply the color scheme to a subset of symbol classes only, select those classes by highlighting them on the table on the Classes tab in the Symbology pane. (Press Shift or Ctrl while clicking in the Upper value or Label columns to select symbol classes.) With symbol class rows selected, choose a color scheme from the Color scheme drop-down list at the top of the Symbology pane.
Click the Clear Selection button
to unselect symbol classes if necessary.
Set the color scheme target
If you are symbolizing polygons, click the Color scheme options button 
to choose the target for the color scheme. You can apply the colors to the polygon fills, outlines, or both.
When you change the color scheme target, the other symbol layers of the polygons symbolizing each symbol class are not updated. For example, when you set the color scheme target to Apply to outline, the fill symbol layers are not updated and setting it to Apply to fill does not alter the outlines of the polygons. This is to ensure that customized symbology is not lost. Symbol layers that are color locked are not updated by changes to the color scheme, regardless of the color scheme target setting.
To update all symbol layers to match the color scheme target setting, click the More drop-down menu and click Regenerate all symbols.
| Color scheme target | Result | Result after regenerating symbols |
|---|---|---|
| Apply to fill | The color scheme is applied to the fills (fill symbol layers) of the polygon symbols. | The color scheme is applied to the fills of the polygon symbols. Polygon outlines (stroke symbol layers) are solid gray lines. |
| Apply to outline | The color scheme is applied to the outlines (stroke symbol layers) of the polygon symbols. | The color scheme is applied to the outlines of the polygons. Polygon fills are fully transparent. |
| Apply to fill and outline | The color scheme is applied to the fills and outlines (fill symbol layers and stroke symbol layers) of the polygon symbols. | The color scheme is applied to the outlines of the polygons. The color scheme is applied to the fills of the polygons as hatches. |
Modify graduated color symbology
From the Primary symbology tab , on the Classes tab, you can do the following:
- To refine the classification, you can edit the Upper value of each classification manually by typing new values.
- To set a critical break around a central, important value, right-click the symbol class and click Set as critical break
. Choose a diverging color scheme to highlight the central value. To remove a critical break, right-click the symbol class and click Remove critical break 
. To remove a classification break, right-click the Upper value cell and click Remove 
. - To show values that are out of range (either because they were newly added, fall in removed classes, or contain null values), click More, and click Show values out of range. If the source data has changed or been updated, click More, and click Refresh values to update the range of values.
- To show the total feature count of each symbol class, click the More menu and choose Show count. If excluded values or out of range values are not shown in the legend, their respective total counts are listed at the bottom of the Symbology pane. To update the feature count, right-click the Count column in the table and choose Refresh count.
- To edit a symbol, click the symbol in the Symbol cell to open the Format Symbol pane.
- To set the symbol's legend patch shape, click the drop-down arrow next to the symbol. To change multiple legend patch shapes at a time, press Shift or Ctrl while clicking to select the symbols, right-click a selected value, and click Update legend patch.
- To reset each symbol class to its default symbol based on current symbology parameters, click the More drop-down menu and click Regenerate all symbols. You may want to do this after you've changed the color scheme target or to return to original settings after making a large number of individual symbol edits.
- To edit a label, right-click the text in the Label cell and click Edit label.
From the Advanced symbology options tab 
, you can do the following:
- To format the labels, expand Format labels.
- By default, the sample size used to calculate statistics and class ranges is set to 10,000 records. To change the maximum sample size, expand Sample size and modify the Maximum sample size value. Limiting the sample size can improve performance but may inadvertently omit important outliers in the dataset. Generally, the larger the dataset, the larger the sample size to use.
- To set up masking per feature, expand Feature level masking.
- To exclude data values from the symbology scheme and optionally define an alternate symbol for excluded values, expand Data exclusion to define the query. To stop showing excluded values, on the Primary symbology tab , click More, and uncheck Show excluded values.
Modify class breaks with a histogram
The histogram offers a visual tool for editing the classes and understanding how the data is represented by different classification methods. Access it by clicking the Histogram tab on the Primary symbology tab .
- The gray bars of the histogram represent the distribution of the data. The value stops along the side show how the current classification method applies to the data distribution.
- To view the distribution and class breaks more easily, you can drag the expander bar above the histogram upward to make it larger in the pane.
Note:
Making dynamic edits to the histogram switches the classification method to Manual.
Vary graduated color symbology by transparency, rotation, or size
In addition to specifying the magnitude of features with graduated color symbology, you can also symbolize additional attributes by varying the transparency, rotation, and size of the graduated color symbols. These variations are sometimes called visual variables. While all of these visual variables can be applied simultaneously, be aware that too many variations make the layer difficult to interpret. It is advisable to apply secondary visual variable symbology sparingly.
Learn more about symbolization concepts
- In the Symbology pane, click the Vary symbology by attribute tab
. - Expand Transparency, Rotation, or Size.
In the case of polygon features, Outline width replaces Size, and Rotation is not available.