> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# U.S. State and County Maps

In Domo, you can add maps representing data for U.S. Counties. You do this by building a U.S. State map or a U.S. County map. These are nearly the same, with one important difference. U.S. County maps show County data on the *national* level—that is, your County data appears on a map of the entire United States (though you can add a [drilldown](/s/article/360042924094 "Adding Drill Path to Your Chart") allowing users to jump to individual states). U.S. State maps, on the other hand, automatically zoom in on the State indicated in your DataSet, allowing you to build maps for individual States.

Both U.S. State and U.S. County maps require a column or row containing the FIPS codes representing each County and another containing the values for each such County. A FIPS code is a five-digit number that identifies Counties and County equivalents in the United States, certain U.S. possessions, and certain freely associated States. The first two digits are the FIPS State code and the last three are the County code within the State or possession. For example, the FIPS State code for Florida is 12, and the FIPS County code for Miami-Dade County is 086, so to represent Miami-Dade County in your DataSet you would use the number "12086."

You can find FIPS codes for any U.S. county by setting up the Domo Dimensions Connector using the following steps:

1. Navigate to the **Appstore**.
2. Type **Domo Dimensions** into the Search bar.
3. Select the Domo Dimensions Connector.

   <Frame>
     <img alt="Domo_Dimensions.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/STh97d86twEaUU5_/images/kb/ka05w00000125XQ-00N5w00000Ri7BU-0EM5w000005vP3O.png?fit=max&auto=format&n=STh97d86twEaUU5_&q=85&s=5f56d34411d52aa2ad07249b15434642" width="367" height="258" data-path="images/kb/ka05w00000125XQ-00N5w00000Ri7BU-0EM5w000005vP3O.png" />
   </Frame>
4. Click **Get the data**.
5. Select the **zips\_to\_fips\_latest.csv** file.
6. Click **Next**.
7. Name the DataSet.
8. Click **Save**.
9. Join the Domo Dimensions DataSet you just created to your data on the Zip column.

<Tip>
  **Tip:** In Domo, maps are generated based on the existing data you provide. When building a U.S. State map, you can use ZIP codes instead of FIPS codes. Your map will then automatically switch to a ZIP code-level map. If a column name includes "st" (short for "state") the state-level map will load. If the column name in the ETL is "zip2fip," the zipcode-level map will load. When using the US counties map, you can use either ZIP codes or FIPS codes in the county selector. Domo will try and match FIPS or ZIPS by matching column name clues like "Zip" or "zip code". It will try "FIPS" or "county" for the county column name.
</Tip>

If you want to build a U.S. State map and your DataSet includes information for multiple States, you can select the State you want to show by [applying a filter](/s/article/360042924074 "Adding Filters to Your Chart").

Values in your U.S. State or U.S. County map are represented by varying shades of color, each of which corresponds to a specific range. Ranges are determined automatically based on the distribution of values in your DataSet and are represented by a legend, which is automatically included beside the map.

<Note>
  **Note:** When multiple instances of a single region occur in a DataSet, the values for that region are summed to show a single value for the region in the map. For example, if your DataSet contained three rows for "Georgia," the values for the rows would be summed, and the Georgia region in the map would show the total value. You *cannot* turn off this automatic aggregation in maps.
</Note>

For information about Country maps, see [Latitude-Longitude Map](/s/article/360043429213 "Country Map").

For information about troubleshooting when an area in your map does not show data but there is data, see [Troubleshooting](/s/article/360043427473 "Troubleshooting").

## Powering U.S. County Maps

In the Analyzer, you choose the columns containing the data for your map. For more information about choosing data columns, see [Applying DataSet Columns to Your Chart](/s/article/360043428713 "Applying DataSet Columns to Your Chart").

For more information about formatting charts in the Analyzer, see [Visualization Card Building Part 2: The Analyzer](/s/topic/0TO5w000000ZaoUGAS "KPI Card Building Part 2: The Card Builder").

The following graphic shows you how data from a typical column-based spreadsheet is converted into a U.S. County map:

<Frame>
  <img alt="" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/STh97d86twEaUU5_/images/kb/ka05w00000125XQ-00N5w00000Ri7BU-0EM5w000005vP3M.png?fit=max&auto=format&n=STh97d86twEaUU5_&q=85&s=24994141f2ffeb47453ee6be6465ef07" style={{width: 712, height: 808}} width="712" height="808" data-path="images/kb/ka05w00000125XQ-00N5w00000Ri7BU-0EM5w000005vP3M.png" />
</Frame>

## Powering U.S. State Maps

This scenario is the same as the one for powering a U.S. County map. If your DataSet contains data for more than one State, you will need to point to the desired State by [adding a filter](/s/article/360042924074 "Adding Filters to Your Chart"). For example, if your DataSet contained data for all of the States in the "South" region but you only wanted to show a map for Florida, you would follow these steps:

1. Build your map by dragging your "FIPS" and value columns into the fields above the chart preview area.
2. Drag your "State" column into the **Filters** pane.
3. Check the box for "Florida."
4. Click **Apply**.

Your preview should now update to show a zoomed-in map of Florida.

## Customizing U.S. County/U.S. State Maps

You can customize the appearance of a U.S. County or State map by editing its **Chart Properties**. Properties for all chart types are listed and described in [Chart Properties](/s/topic/0TO5w000000ZaodGAC "Chart Properties"). Unique properties of U.S. County and State maps include the following:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:209;a"><thead><tr><th colspan="1" rowspan="1"><p> Property </p></th><th colspan="1" rowspan="1"><p> Description </p></th><th colspan="1" rowspan="1"><p> Example </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Theme > Theme </p></td><td colspan="1" rowspan="1"><p> Allows you to change the color theme for the map. For more information about setting colors, see <a href="/s/article/360043429653" target="_blank" title="Changing the Default Colors in Your Chart"> Changing the Default Colors in Your Chart </a>. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> General > Balanced Distribution </p></td><td colspan="1" rowspan="1"><p> Adjusts maps to include a balanced number of items within each range. This is helpful in spreading values across each range when your data contains extreme outliers. </p><p> The pair of maps in the screenshots at right show how <b> Balanced Distribution </b> works. (These are Country maps for Canada, not World maps, but the principle is the same.) In these maps, the values of most of the Canadian provinces are in the range of 100 to 1500. The outlier, Alberta, has a value of 10,000. <b> Balanced Distribution </b> has not been turned on in the top map, so a skewed version of the data is shown—Alberta appears dark and all of the other provinces appear light. In the bottom map, the user has turned on <b> Balanced Distribution </b>, so Alberta is grouped into the same range as the province with the next highest value. </p></td><td colspan="1" rowspan="1"><p><img alt="balanced_distribution_off.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/D4XP-ZUu0hZKYNDT/images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1n.png?fit=max&auto=format&n=D4XP-ZUu0hZKYNDT&q=85&s=df099a8007a5e27fe8537a20ea390b95" width="632" height="373" data-path="images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1n.png" /></p><p><img alt="balanced_distribution_on.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/D4XP-ZUu0hZKYNDT/images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1u.png?fit=max&auto=format&n=D4XP-ZUu0hZKYNDT&q=85&s=e0bc28e083250335bb1c5b2c830f9513" width="632" height="373" data-path="images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1u.png" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> General > Auto Zoom to Data </p></td><td colspan="1" rowspan="1"><p> Zooms in on the region of your map with data. In the example at right, the only States with data are Utah, Arizona, Colorado, and New Mexico, so the map zooms on them automatically. This option will not work if all of the regions in your map with data are not adjacent. For example, if the map at right showed Oregon as having data, the auto-zoom would not work because Oregon is not adjacent to any of the other States with data. </p></td><td colspan="1" rowspan="1"><p><img alt="map_auto_zoom_to_data.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/D4XP-ZUu0hZKYNDT/images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP28.png?fit=max&auto=format&n=D4XP-ZUu0hZKYNDT&q=85&s=7999e8b835b7c9ffa8f769f7551a889e" width="800" height="320" data-path="images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP28.png" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> General> Hide No Data Items </p></td><td colspan="1" rowspan="1"><p> Hides all items in your map without data. In the example at right, the only States with data are Utah, Arizona, Colorado, and New Mexico, so the map hides all other States. Unlike the "Auto Zoom to Data" property, this will work even if there are regions not adjacent to other regions. </p></td><td colspan="1" rowspan="1"><p><img alt="map_hide_no_data_items.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/D4XP-ZUu0hZKYNDT/images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1s.png?fit=max&auto=format&n=D4XP-ZUu0hZKYNDT&q=85&s=e6fbf0d9c9ec0dbf704eb1551bf00535" width="1981" height="819" data-path="images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1s.png" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> General > Hide Abbreviated Legend </p></td><td colspan="1" rowspan="1"><p> Hides the legend shown at the bottom of maps in some views. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> General > Override Maximum Value </p></td><td colspan="1" rowspan="1"><p> Lets you specify the maximum value for a map or Heat Map. </p><p> By default, Domo uses the highest value in the DataSet as the maximum value. However, by setting this property you can override this value. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Hover Legend > Hide Legend </p></td><td colspan="1" rowspan="1"><p> Hides the legend that normally appears on the right side of a map in the Details view. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Hover Legend > Hide Total </p></td><td colspan="1" rowspan="1"><p> Hides the "Total" section of the legend that appears on the right side of a map in the Details view. The example shows a map in which this has been done. </p></td><td colspan="1" rowspan="1"><p><img alt="map_data_labels_hide_total.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/D4XP-ZUu0hZKYNDT/images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP24.png?fit=max&auto=format&n=D4XP-ZUu0hZKYNDT&q=85&s=41749557f65727262304bc844950c7d1" width="800" height="494" data-path="images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP24.png" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> Hover Legend > Hide Values </p></td><td colspan="1" rowspan="1"><p> Hides the value and percent of total value in the legend that appears on the right side of a map in the Details view. The example shows a map in which this has been done. </p></td><td colspan="1" rowspan="1"><p><img alt="map_data_labels_hide_values.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/D4XP-ZUu0hZKYNDT/images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1x.png?fit=max&auto=format&n=D4XP-ZUu0hZKYNDT&q=85&s=78805cdf16870e8f7b49ca1e90e966ac" width="800" height="504" data-path="images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1x.png" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> Data Label Settings > Text </p></td><td colspan="1" rowspan="1"><p> Specifies text for the data labels. This property is the "on switch" for data labels—you must specify text for them to appear. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Data Label Settings > Font Size </p></td><td colspan="1" rowspan="1"><p> Allows you to increase or decrease the data label font size. The "Default" font size falls between the largest and second-smallest font sizes. For more information, see <a href="/s/article/360042925214" target="_blank" title="Changing the Font Size in Your Chart"> Changing the Font Size in Your Chart </a>. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Data Label Settings > Text Color </p></td><td colspan="1" rowspan="1"><p> Lets you determine the text color for your map data labels. If you select "Default," the color will be automatically determined based on the background color. This is shown in the example at right, in which the data labels on darker areas appear white and those on lighter areas appear dark red. </p></td><td colspan="1" rowspan="1"><p><img alt="map_data_labels_text_color.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/D4XP-ZUu0hZKYNDT/images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1o.png?fit=max&auto=format&n=D4XP-ZUu0hZKYNDT&q=85&s=1e13fd5cf9f2969e3b102ec76f87a4ae" width="800" height="749" data-path="images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1o.png" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> Data Label Settings > Value Abbreviation </p></td><td colspan="1" rowspan="1"><p> Determines whether data label values are abbreviated (the default being 3 significant digits) or not. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Data Label Settings > Fill </p></td><td colspan="1" rowspan="1"><p> Lets you add a colored fill to your map data labels. The example at right shows a chart in which a pale blue fill color with 60% transparency has been added. </p></td><td colspan="1" rowspan="1"><p><img alt="map_data_labels_fill.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/U1MglXZKeJZebGlP/images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1l.png?fit=max&auto=format&n=U1MglXZKeJZebGlP&q=85&s=37d6316fb84225768a7b15c136c49387" width="884" height="811" data-path="images/kb/ka05w00000123lV-00N5w00000Ri7BU-0EM5w000005vP1l.png" /></p></td></tr><tr><td colspan="1" rowspan="1"><p> Data Label Settings > Fill Color </p></td><td colspan="1" rowspan="1"><p> Lets you specify the color for the fill in your map data labels. This property is only available when you check the <b> Fill </b> box. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Data Label Settings > Fill Transparency Percent </p></td><td colspan="1" rowspan="1"><p> Lets you specify the fill transparency for map data labels. You can specify any number between 0 and 100, in which 0 is completely opaque and 100 is completely transparent. This property is only available when you check the <b> Fill </b> box. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Hover Text > Hover Text </p></td><td colspan="1" rowspan="1"><p> Lets you set the text that appears in map hovers. A variety of macros for showing map values in your hovers is available. For more information and a list of available macros, see <a href="/s/article/360043429693" target="_blank" title="Formatting Data Label and Hover Text in Your Chart"> Formatting Data Label and Hover Text in Your Chart </a>. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Hover Text > Always Show Over Map </p></td><td colspan="1" rowspan="1"><p> Specifies whether hover text specified using the <b> Hover Text </b> option is turned on for your chart. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Values > Label Format </p></td><td colspan="1" rowspan="1"><p> Determines the general number format for hover text and legend items in maps. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Values > Decimal Places </p></td><td colspan="1" rowspan="1"><p> Determines the number of decimal places used in decimal values in hover text and legend items in maps. </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"><p> Values > Negative Numbers </p></td><td colspan="1" rowspan="1"><p> Determines the format for negative numbers in hover text and legend items in maps </p></td><td colspan="1" rowspan="1"><p> — </p></td></tr><tr><td colspan="1" rowspan="1"> Cities > Cities </td><td colspan="1" rowspan="1"><p> Shows whether cities and city names are shown on the map. The closer a map is zoomed, the more cities are shown. </p><p> The first example at right shows an "unzoomed" map of the United States. Note that only two cities are shown in Texas. In the second example, the map is zoomed to show only Texas, and many more cities are shown. </p></td><td colspan="1" rowspan="1"><p><img alt="country_map_with_cities.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/9GmyphKXosOtxL2U/images/kb/ka05w00000123xT-00N5w00000Ri7BU-0EM5w000005vWF2.png?fit=max&auto=format&n=9GmyphKXosOtxL2U&q=85&s=079f6b0bc96531f43cfa0538e2dc3b32" width="1169" height="754" data-path="images/kb/ka05w00000123xT-00N5w00000Ri7BU-0EM5w000005vWF2.png" /></p><p /><p><img alt="country_map_with_cities_zoomed.png" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/9GmyphKXosOtxL2U/images/kb/ka05w00000123xT-00N5w00000Ri7BU-0EM5w000005vWEv.png?fit=max&auto=format&n=9GmyphKXosOtxL2U&q=85&s=14b2e8ca5bbcf68208d427ef88df94fb" width="800" height="531" data-path="images/kb/ka05w00000123xT-00N5w00000Ri7BU-0EM5w000005vWEv.png" /></p></td></tr></tbody></table>
