Legend Panel - Maps

Where to Use

Common Fields

Legend Type (for numeric maps):

• Equal Number (Quantiles): Each category contains about the same number of geographic areas. This makes patterns across ranks easy to see, but the value ranges may be uneven. The user can set the number of categories.
• Equal Interval: Each category covers the same-sized value range. This makes the scale easy to interpret, but many areas may fall into one category if the data are clustered. The user can set the number of categories.
• Manual Breakpoints: Allows the user to manually set the Upper Bound for each category. The user can set the number of categories

Show Legend: Unselecting this option hides the legend from the page.

Legend Position: This moves the legend either to the left, right, top, or bottom of the chart.

Legend Style: Choose from circles, squares, or a gradient bar.

Gradient Style: Gradient Legends only. Linear Blocks or Smooth. The smooth option will blur the colors together at the transition point, so it is best used for an intensity scale with many options. If using text categories, please double check them on mobile view for text overlap.

Legend Separators: Gradient Legends in Linear Block style only. Put a white spacer between sections of the legend by entering the legend block number you would like the spacer to appear after. Multiple spacers can be separated by a comma. This is particularly useful if you have a legend that is not continuous.

Tick Rotation (Degrees): Gradient Legends only. Change the angle of the text on the legend for better visibility.

Single Column/Row Legend: Places all data series on a single row across or a single vertical column.

Legend Group By: Categorical Maps only. Select a data column to group your legend by. This feature works like a pivot table.

Vertical Sorted Legend: Sorts the columns vertically instead of horizontally.

View Larger

Show Special Classes Last: Show any special classes at the end of the legend, rather than the default first position.

Include Non-Geographic Categories: Categorical maps only. Adds category values from data rows that are not matched to a map geography to the legend. These rows do not display on the map or in the map data table.

Separate Zero: For numeric maps, select this option to place zero in its own data class. It is available for Equal Number (Quantiles), Equal Interval, and Manual Breakpoints legends. For Equal Number (Quantiles) and Equal Interval legends, zero counts as one of the selected data classes. For Manual Breakpoints legends, zero appears as a separate class alongside the manual ranges. If using a gradient style, zero appears as a separate block before the remaining gradient.

• Separate Zero Migration Note: Equal Number (Quantiles) map legends use the current quantile classification behavior automatically. Newly created maps, imported Vega maps, and maps added inside dashboards are seeded with the current setting. Saved maps that do not include the compatibility flag receive the current value during config backfill, and saved maps that include "general.equalNumberOptIn: false" still render with the current Equal Number behavior. Authors do not need to select a separate opt-in control.

Number of Items: Select the number of data classes to display. Do not include special classes, these are counted separately.

Category Sort: Categorical maps only. Controls how category legend items are ordered.

• Automatic sort: Places numeric values and numeric ranges first, ordered by their numeric bounds. Non-numeric categories appear after numeric categories in data order. If the legend does not contain numeric categories, categories stay in data order.
• Custom sort: Shows Category Order so you can drag categories into a preferred legend order.

Category Order: Custom sort only. Drag categories into the preferred legend order. If the data classification is based on intensity, place the values in order of intensity, from low to high or high to low.

Bubble Size Sort: For Bubble Maps. Select how category labels are ordered when Bubble Size Type is set to Categorical.

• Automatic sort: Places numeric values and ranges first, ordered by their numeric bounds. Non-numeric categories appear after those in data order.
• Custom sort: Displays a Category Order list where you can drag category labels into the preferred size order. The same order controls bubble sizes and the bubble-size legend.

Legend Title: Create a title for your legend. Can be HTML formatted.

Legend Description: Enter a description for your legend. This can be HTML formatted.

US State Map Specific Fields

Unified Legend: If you are including one or more data filters and want the high and low values in the legend to be based on all mapped values, check this option. Otherwise, the legend high and low values are determined by the numeric range of the selected filter value set.