> ## 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.

# World Map

## Intro

In Domo, you can create a World Map that represents data for world nations. A World Map requires two data columns or rows from your DataSet: one containing country names or two-letter ISO codes (such as AU for Australia) and the other containing the values for each country. These values are represented in your map by varying colors, each corresponding to a specific range. Ranges are determined automatically based on the distribution of values in your data and are represented by a legend, which automatically appears beside the map. For information about value, category, and series data, see [Understanding Chart Data](/s/article/360043428693 "Understanding Chart Data").

All nations and most territories are represented. For a list of countries and their corresponding ISO codes, see [Supported Country Codes](#h_6f81682a-711f-44c4-af4b-277f17e8c6ac "World 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 Continental or Regional maps, see [U.S. County Map/U.S. State Map](/s/article/360042925074 "Continental/Regional Map").

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

**Video - Map Charts**

<iframe allowfullscreen="" frameborder="1" height="315" src="//www.youtube-nocookie.com/embed/ahzrs6FI3uk" width="560" />

## Powering World 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 World Map:

<Frame>
  <img alt="" src="https://mintcdn.com/domoinc-openapi-sync-dataflows/9GmyphKXosOtxL2U/images/kb/ka05w00000123xT-00N5w00000Ri7BU-0EM5w000005vWF8.png?fit=max&auto=format&n=9GmyphKXosOtxL2U&q=85&s=b7528b44c8c489b10303fa6d5ed98bf3" style={{width: 714, height: 766}} width="714" height="766" data-path="images/kb/ka05w00000123xT-00N5w00000Ri7BU-0EM5w000005vWF8.png" />
</Frame>

## Customizing World Maps

You can customize the appearance of a World Map by editing its **Chart Properties**. For information about all chart properties, see [Chart Properties](/s/topic/0TO5w000000ZaodGAC "Understanding Chart Data"). Unique properties of World 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><a target="_blank" title="/@api/deki/files/113/balanced_distribution_off.png"><img alt="" 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" /></a></p><p><a target="_blank" title="/@api/deki/files/114/balanced_distribution_on.png"><img alt="" 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" /></a></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><a target="_blank" title="/@api/deki/files/5247/map_auto_zoom_to_data.png"><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" /></a></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><a target="_blank" title="/@api/deki/files/5246/map_hide_no_data_items.png"><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" /></a></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><a target="_blank" title="/@api/deki/files/5251/map_data_labels_hide_total.png"><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" /></a></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><a target="_blank" title="/@api/deki/files/5252/map_data_labels_hide_values.png"><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" /></a></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><a target="_blank" title="/@api/deki/files/5254/map_data_labels_text_color.png"><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" /></a></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><a target="_blank" title="/@api/deki/files/5253/map_data_labels_fill.png"><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" /></a></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><a target="_blank" title="/@api/deki/files/5442/country_map_with_cities.png"><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" /></a></p><p /><p><a target="_blank" title="/@api/deki/files/5441/country_map_with_cities_zoomed.png"><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" /></a></p></td></tr></tbody></table>
