Docs Menu

Choropleth Chart Shape Schemes

MongoDB Charts provides shape schemes to help define regions in your Choropleth Charts. Each shape scheme has a distinct set of expected values where each value corresponds to a region.

In choropleth charts, you specify regions with the Location channel. The value in the location channel must match a region value for the selected Shape Scheme (case insensitive). For example, when using the US States scheme, the region of California will match both california and CA as well as California.

The following table defines the available shape schemes and their expected Location values:

Shape Scheme
Countries and Regions

Default shape scheme. Accepts full country names (e.g., Brazil) and 2-letter ISO country codes (e.g., BR).

Also accepts some common country name variants (e.g., United States and USA).

US States
Accepts full United States state names and 2 letter US state abbreviations. For example, New York or NY.
Canadian Provinces
Accepts full Canadian province names (English or French) and 2 letter Canadian province codes. For example, New Brunswick or Nouveau-Brunswick.
UK Countries

Accepts the following UK Countries:

  • England
  • Scotland
  • Wales
  • Northern Ireland
UK Counties and Districts

Accepts local administrative counties across the United Kingdom. For example, Norfolk or Essex.


This shape scheme does not include ceremonial counties.

German States
Accepts full German state names (English or German) and 2 letter German state codes. For example, Saxony or Sachsen.
Australian States
Accepts full Australian state names and 2-3 letter Australian state abbreviations. For example, Victoria or VIC.
Australian Local Government Areas
Accepts Australian local government areas. For example, Yarra or Waverley.
Give Feedback
© 2021 MongoDB, Inc.


  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.