Mapbox Boundaries powers geospatial analysis and visualizations to derive valuable insights from any dataset.

Fast rendering of millions of boundaries

Detailed boundaries edge-matched throughout zoom levels all seamlessly served from Mapbox vector tiles.

Connect data to any polygon

Utilize detailed metadata to join geographic data to specific polygons, enabling dynamic visualizations and geospatial analysis.

See data from localized worldviews

Mapbox Boundaries supports multiple worldviews for all boundaries and provides full control over styling of disputed borders.

Explore our coverage map

5 million boundaries covering Political, Statistical, State, County, City and Zip Code areas, expertly curated across every country

See how our customers are building with Boundaries

From business intelligence analysis and data journalism to territory planning and logistics management, customers utilize spatial analytics in countless solutions.

“Our customers are thrilled they can quickly glean insights from billions of data points by drilling down from the country level all the way down to municipality.”

Jose Nocedal, Vice President - Technology at MicroStrategy

Precision at every level

Other datasets typically simplify boundaries, which makes your visualizations inaccurate. Polygons in Mapbox Boundaries are always perfectly edge-matched to adjacent features within a seamless hierarchy of spatial layers, to cleanly visualize the entire world at any scale.

Customize and merge boundaries

Geometries are georeferenced and served from Mapbox vector tiles, allowing easy merging of multiple polygons to form custom areas. Test merging polygons in our Sales Planner playground and watch the data update dynamically.

Seamless integration with Mapbox developer tools

Add Boundaries to basemaps and style them in Studio. Match point features to boundaries using the Tilequery API. Render maps on a website or app with Mapbox GL JS. Build dashboards on-premise with Atlas. All with just a few lines of code.

High-Resolution Country Polygons in Studio

The collection of high resolution administrative level-0 country polygons in Mapbox Boundaries is now available to all designers and developers using the new version of Studio, for free. The individual country polygons include updates to major disputed areas and support of different worldviews, making it easy to create accurate country level choropleths or create custom styles for individual countries.

Enhance BI dashboards with Boundaries

BI platforms such as Tableau and Microstrategy trust Mapbox Boundaries as the data source behind their geospatial analysis capabilities. Regardless of the platform, Mapbox Boundaries add value to dashboards with unmatched geographic precision and countless data aggregation possibilities.

"Tableau" logo."Census 2000" logo.

Frequently asked questions


What is Mapbox Boundaries?

Mapbox Boundaries is an expertly curated set of global boundary data that allows you to add boundaries to your maps, dashboards, and data visualizations. Mapbox Boundaries consists of multiple data layers that come cartographically-matched, georeferenced, and processed as a Mapbox vector tileset ready for integration with your maps and data.

Why should I use Mapbox Boundaries?

Mapbox Boundaries makes your maps more useful by enabling you to interact with world polygons, adding valuable context to your maps and supporting comprehensive analysis. This added coverage can help:

  • A sales team visualizing revenue by US state to determine territories.
  • A real estate firm counting POIs by US zip code to build a “livability” index.
  • A regional disaster response center using city and county boundaries to determine jurisdiction for emergency response.
  • A utility or energy company visualizing and assessing localities affected by transmission infrastructure planning.
  • A business intelligence platform wanting to help their customers do any of the above and more around the world.

What boundary data types are available?

There are currently five data types in Mapbox Boundaries:

  • Administrative: Divisions within a country or territory delineated for the purpose of general administration. These usually have a capital and some type of government of their own, with the power to set laws and collect taxes throughout the division.
  • Legislative: Constituency areas for various types of legislative assemblies or regional councils. Typically voters elect a single representative to a larger body from each of these areas.
  • Locality: These are types of places that do not necessarily represent any official boundaries, but are nonetheless commonly used as definitions of “place.”
  • Postal: These are approximate areas of mail delivery based on national postal code systems.
  • Statistical: These are non-administrative boundaries that are most commonly used for statistical purposes. These might be officially defined by a governmental statistical bureau, or historical administrative boundaries that are still relevant for statistical uses (e.g. Census blocks in the US).

Where is Mapbox Boundaries available?

Mapbox Boundaries is a world wide, curated data product that covers everything from Chinese prefectures and Japanese 7-digit postal codes to French arrondissements and US neighborhoods. Exact coverage varies by country and we encourage you to explore the Mapbox Boundaries country explorer to see all of the data available to you.

Additionally, Mapbox Boundaries has worldviews for Chinese, Japanese, Indian, and a US / International audiences, so you can provide localized context for data to your customers wherever they do business.

How do I use Mapbox Boundaries?

Follow this getting started guide to begin building maps with Mapbox Boundaries.

What are some of the key capabilities of Mapbox Boundaries?

Mapbox Boundaries facilitates data driven decision making by enabling you to join custom data with boundary polygons. The data product also allows you to visualize your data by areas such as country, region, sub-region, or post code to unlock insights within your own application. You can:

  • Group and aggregate statistics by any type of boundary, including easy drill down, with Data-Joins.
  • Match point features — any longitude & latitude — to any boundary from our Tilequery API.
  • Extend Mapbox Boundaries with any custom polygons you need for your application.

Here is an example that demonstrates how a user can aggregate point data into polygon hierarchies (using the data join technique and the Tile Query API) to analyze hospital charges in the US - all rendered through an interactive map with GL JS.

Data Format

What format are the boundaries available?

All of our Boundaries are available via Mapbox vector tiles or in flat file GeoJSON format.

What metadata attributes are included with Mapbox Boundaries polygons?

Please refer to the feature lookup tables that can be found in our Mapbox Boundaries getting started guide.


How do I buy Mapbox Boundaries?

Great question! Talk to our sales team or your Mapbox representative.

How can a user add the Mapbox Boundaries layers to a style in Studio?

To add Mapbox Boundaries to a map style in Mapbox Studio, select the “Add Layer” button and view the “Sources” tab. Next, add the desired tilesets as a layer within a map by selecting specific boundary tilesets from the list of Mapbox Boundaries tilesets. Access to the Mapbox Boundaries tilesets is controlled by your Mapbox account access token. If you would like a trial of Boundaries, please contact our sales team

Pricing and Licensing

How much does Mapbox Boundaries cost?

Mapbox Boundaries is available as part of an annual subscription plan. For specific pricing quotes, please talk to our sales team or your Mapbox representative.

Are there any licensing or usage restrictions for Mapbox Boundaries?

Yes. Boundaries may only be used in conjunction with a Mapbox Map, and you may not (and may not permit any third party to) trace or otherwise derive or extract content, data and/or information from Boundaries. You may only access Boundaries via the Mapbox APIs (i.e., not as a data file). Please see the Mapbox Service Terms for a complete version of our Service Terms.