Skip to main content



Q4 2023


  • Data refresh of Africa and Oceania regions with latest administrative, postal, statistical and legislative changes up to 2022
  • Additional updates to Philippines, South Korea and Japan based on latest changes

Boundary changes

  • Algeria:
    • 10 new provinces (admin-1)
    • 37 new communes (admin-2)
    • 10 new 2-digit postcode area (postal-3)
  • Australia
    • 11,000 new statistical areas (stats-2/3/4/5)
    • 8 new 4-digit postcode areas (postal-4)
    • Update admin codes to match official local government area codes
  • Democratic Republic of the Congo: 13 new cities (admin-2)
  • Egypt: 1 new region (admin-2)
  • Ethiopia:
    • 2 new regions, 6 special districts and 12 zones (admin-2)
    • Reorganized districts and towns (admin-3)
  • Ghana: 25 new municipal districts and 19 districts (admin-2)
  • Japan: Update Hamamatsu ward boundary changes
  • Kenya: 3 new sub-counties (admin-2)
  • Mali: 1 new region (admin-1)
  • Marshall Islands: 9 new municipalities (admin-1)
  • Mauritania: 2 new departments (admin-2)
  • Mozambique: 6 new municipal districts (admin-2)
  • New Zealand
    • 24 new rural settlements (stats-1)
    • 12,000 new statistical areas (stats-2/3/4/5)
    • 18 new wards (admin-3)
    • 2 new 4-digit postcode areas (postal-4)
  • Northern Mariana Islands: Move block groups from stats-4 to stats-5
  • Philippines:
    • Add highly 33 urbanized cities to the same level as province (admin-2)
    • Replace City of Manila with 14 city districts (admin-3)
    • Updated all admin features and codes to match official Philippine Standard Geographic Code (PSGC) list
  • South Korea: Update Daegu City boundary changes
  • Solomon Islands: 1 new capital territory (admin-1)
  • Sudan: 1 new special administrative area (admin-1) and 18 new districts (admin-2)
  • Somalia: 1 new region (admin-1)
  • South Africa: 131 new 4-digit postcode areas (postal-4)
  • South Sudan: 2 new administrative areas (admin-1)
  • Togo: 3 new prefectures (admin-2)
  • Uganda: 1 new county (admin-2)
  • Zambia: 43 new districts (admin-2) and 1 constituency (legislative-1)

New layers


  • British Indian Ocean Territory: postcode unit (postal-4)
  • Burkina Faso: departments (admin-3)
  • Central African Republic: communes (admin-3)
  • Republic of the Congo: districts and communes (admin-2)
  • Ivory Coast: sub-prefectures (admin-4)
  • Lesotho: community council (admin-2), 3-digit postcode areas (postal-4)
  • Madagascar: communes (admin-3)
  • Mauritius: 3-digit postcode areas (postal-3)
  • Namibia: constituencies (admin-2)
  • Niger: 1-digit postcode areas (postal-3)
  • Mali: communes (admin-3)
  • Malawi: traditional authorities (admin-3), 6-digit postcode areas (postal-4)
  • Rwanda: cells (admin-4)
  • Senegal: arrondissements (admin-3)
  • Sierra Leone: chiefdom (admin-3)
  • Tanzania: wards (admin-3)
  • Uganda: 3-digit postcode areas (postal-3), regions (stats-1)


  • Fiji: tikinas (admin-3)
  • Federated States of Micronesia: municipalities (admin-2), 5-digit postcode area (postal-4)
  • Heard Island and McDonald Islands: 2-digit postcode area (postal-3), 4-digit postcode area (postal-4)
  • Kiribati: groups (stats-1), divisions (stats-2), islands (stats-3)
  • Niue: villages (admin-2)
  • Northern Mariana Islands: 5-digit postcode areas (postal-4)
  • Palau: hamlets (admin-2)
  • Pitcairn: postcode unit (postal-4)
  • Samoa: villages (admin-2), 4-digit postcode area (postal-4)
  • Solomon Islands: wards (admin-2)
  • Saint Helena, Ascension and Tristan da Cunha: divisions (admin-2), districts and islands (admin-3), postcode unit (postal-4)
  • Tonga: districts (admin-2) and villages (admin-3)
  • Vanuatu: councils (admin-2)
  • Wallis and Futuna: districts (admin-2), 5-digit postcode areas (postal-4)


  • Saint Pierre and Miquelon: 5-digit postcode area (postal-4)


Q2 2023


  • Data refresh of entire Europe region with latest administrative, postal, statistical and legislative changes up to 2022
  • Addition of Serbia worldview

Boundary changes

  • EU region statistical boundaries updated from NUTS 2016 to NUTS 2021 classification
  • Ireland: Local electoral areas (stats-4 & legislative-4) reorganized to reflect latest 2019 election boundaries
  • Latvia: Administrative restructuring of admin-1 per 2021 territorial reform from 119 counties to 43 counties
  • Netherlands: Municipality (admin-2) boundaries updated
  • Serbia:
    • Update name field from Serbian-Latin to Serbian-Cyrillic for administrative levels for consistency with other boundary types
    • New level of 28 city municipalities (admin-3) covering 5 cities

Data improvements

  • Europe 2022 data refresh
    • 4,600 new administrative boundaries
    • 160,000 new postcode boundaries
    • 43 new statistical boundaries
  • Italy: Align unit_code of municipalities (admin-3) to match ISTAT municipality code
  • Kosovo: Introduce new 1-digit postcode area (postal-1) and 5-digit postcode area (postal-4) coverage
  • Netherlands: Added 3.8k new 6-digit postcodes (postal-4)
  • Ukraine: Added 28k new features for country wide coverage of 5-digit postcodes (postal-4)
  • United Kingdom: Added 89k postcode (postal-4) boundaries
  • Turkey: Expanded coverage of neighborhoods (admin-3) with 4k new boundaries in 84 districts
  • New disputed area polygon for Croatia-Slovenia border dispute iso_3166_1='D0HRSI1'


  • China: Align unit_code of (admin-3) to match official administrative codes
  • Philippines: Updated name and unit_code for admin-1/2/3 to match official PGSC administrative codes

Bug fixes

  • Fixes missing Liancourt Rocks in JP worldview
  • Add missing islands: Niulakita (Tuvalu), Nukulaelae (Tuvalu), and Eldey (Iceland) islands
  • Hungary: district (admin-2) names corrected
  • Canada: census division (stats-2) and census subdivision (stats-3) names corrections
  • Greece: (stats-4/5) fixed names with correct diactrics
  • Spain: Fix capitalization of administrative names
  • United States: locality name corrections for comma separated names (locality-2/3/4)


Q4 2022

Data coverage improvements

This minor release includes an update to the U.S. legislative datasets and U.S. territories based on the decennial redistricting data program from the 2020 Census.


Q3 2022

This major release includes several breaking API and data changes. See Migrate from v3 to v4 for details on migrating your application.

Breaking changes

  • The primary key field in the vector tilesets and lookup tables is now a globally unique mapbox_id. The primary key values of feature_id and id are now deprecated and will no longer work for joins with v4 tilesets. References to all v3 IDs need to be recomputed and all Boundaries tilesets must be added to a Mapbox map using a promoteId: "mapbox_id" argument.
  • Boundaries lookup tables are only delivered in flat CSV format. Nested JSON lookup tables have been deprecated.
  • Several fields in the Boundaries lookup tables have been renamed for consistency.
  • Data reorganization and fixes to many layers have resulted in breaking changes in data coverage:
    • US-legislative layers have been temporarily removed to make way for final 2022 redistricting boundaries in v4.1.
    • US-locality layers have been completely reorganized for parity with Mapbox Search API.
    • See the migration guide for a full list of breaking data layers.

Tileset improvements

Data coverage improvements

  • 🇧🇷 Brazil: 3k+ 5-digit postcode boundaries added
  • 🇰🇭 Cambodia: New 6-digit postcode boundaries 
  • 🇨🇦 Canada: New locality level of 3k+ neighbourhood boundaries
  • 🇮🇳 India: 21 new districts and 800+ subdistricts added
  • 🇮🇩 Indonesia: 
    • Administrative: 500+ districts 4.8k villages added
    • Postal: 2k+ 5-digit postcode boundaries added
  • 🇲🇾 Malaysia: Added new division level for Sabah and Sarawak states
  • 🇲🇽 Mexico: 20k+ 5-digit postcode boundaries added
  • 🇷🇺 Russia: 1k+ 6-digit postcode boundaries added
  • 🇹🇷 Turkey: 4k+ neighborhoods added
  • 🇺🇦 Ukraine: Reorganized administrative boundaries introduced in 2020
  • 🇺🇸 United States
    • Administrative: Updated with latest changes as per Census 2020
    • Statistical: Updated census tracts and block groups per Census 2020
    • Postal: Improved zip code boundaries validated with USPS zip code list. Added boundaries for 3-digit zip code groups 
    • Legislative: Placeholder for congressional and state redistricting expected in late 2022
    • Locality: Expanded coverage and data parity with Mapbox search API with 123k+ new place and neighborhood boundaries
  • 🇻🇳 Vietnam: Reorganized postal boundaries introduced in 2017
  • 🌎 Rest of North and South Americas, Asia
    • Refreshed geometries and metadata with latest available data sources


Q4 2021

Worldviews / Disputes

Data coverage improvements


Q3 2021

Data coverage improvements


Q1 2021

Worldviews / Disputes

  • Add Nogorno Karabkh disputed area boundary based on 1994 ceasefire line.
  • Add Kuril and Dokdo-ri islands to Japan worldview.


  • New grouping_attribute. This JSON string captures relevant "groupings" or "aggregated areas" that the individual feature is a part of. Initial data additions include:
    • Added UN M49 region and subregion names at admin-0.
  • New joined_attribute. This JSON string lists codes that are helpful for joining data against the feature.
    • Added ISO 3166-2 codes as part of join_attributes, primarily at admin-1 but some at admin-2.
    • Added UN M49 region and subregion IDs at admin-0.
  • Significant improvements to fill rates and density of metadata attributes:
    • Added admin-0 full language coverage for all Mapbox Streets-supported languages.
    • 100% Wikidata and municipality code coverage for France, Belgium, Germany, Netherlands, Greece, Poland, Portugal, Spain, Italy, and Czech.
    • Ukraine and Poland name and alias improvements.

Data coverage improvements

  • Refresh of EU admin, postal, and statistical layers


Q3 2020

Data coverage improvements

  • Refresh of Australia, Asia, and Africa that includes over 150,000 new polygons in additional coverage.


Q1 2020

Release blog post

Data types and tilesets

  • Two new data types, locality and legislative, will be included as part of the product to complement the existing data types of administrative, postal, and statistical.
    • The locality data type will have 4 levels that aim to capture local expectations of settlements that have non-official or fuzzy areas: Level 1 = Metro */} Level 2 = City */} Level 3 = District */} Level 4 = Neighborhood.
    • The legislative data type will have 5 levels that capture electoral boundaries: Level 1 = National Upper (aka US Senate) */} Level 2 = National Lower (aka US House of Representatives) */} Level 3 = Regional Upper (State Senate) */} Level 4 = Regional Lower (State House) */} Level 5 = Local (Community or Town specific boundaries).
  • Separated lines and points tilesets that enable the inclusion of names on a map from the points tilesets.

Worldviews / Disputes

Data coverage improvements

  • US scope expanded to include cities and municipalities. The definition of a city is fluid in how it’s used and perceived by people. To avoid misrepresenting a boundary, we used several data types and levels to properly capture US city and municipality boundary polygons.
  • Admin, level 3 = US county sub-divisions that are active governments or entities with designated officials that provide primary general-purpose functions to their residents.
  • Admin, level 4 = US census incorporated places (excludes Census Designated Places, or CDPs, which are only statistical).
  • Stats, level 3 = all US county sub-divisions (all serve a statistical purpose, while only some serve an administrative purpose).
  • Locality, level 2 = this level was created to provide a one-stop location to provide what people colloquially refer to as a city in the US. It is constructed by using all US county sub-divisions as a basis, then adding all US census places (both incorporated and CDPs).
  • Completed a full review of all global Administrative boundaries, which resulted in recategorizing several boundaries to a statistical or legislative level as the purpose, function, or both purpose and function of those boundaries was changed by the government.


Q4 2019

Release blog post


  • New iso_3166_1_alpha_3. This field is the ISO 3166-1 or Alpha-3 code for a country.

Data coverage improvements

  • 228,000 new boundaries including complete, global admin-1 coverage.
  • Refresh to the Caribbean and South Pacific regions.
  • Updates to US postal-4 (5-digit zip code) layer.


Q3 2019

Release blog post


  • Wikidata IDs, translations and aliases added for admin-1 and admin-2 boundaries.

Data coverage improvements

  • Added two million new boundaries, increasing our data coverage in over 100 countries.
  • Statistical — Over 275,000 new US Census boundaries including metropolitan areas, micropolitan areas, tracts, and block groups.
  • Statistical — Almost 2,000 new European NUTS (Nomenclature of Territorial Units for Statistics) areas across three hierarchical levels
  • Postal — Full detail Postal-4 coverage for countries such as the UK, Netherlands, South Korea and Japan.
Was this page helpful?