No code

Style a single country

With the Mapbox Studio style editor, you can style a single country or region. In this example, you will be styling Australia.

Getting started

Before getting started, you will need a few things:

  • Mapbox account. You will need an account to log in and use the Mapbox Studio style editor. You can create an account at mapbox.com/account.
  • Natural Earth data. Download the Admin 0 - Countries Shapefile from Natural Earth. This data will download as a ZIP file that does not need to be unzipped.

Create a new style

Log into your Mapbox account and navigate to your Styles page. This is where all your styles are listed. A style is a set of rules for how Mapbox will draw the map on a page. It includes references to your data, map images (icons, markers, patterns), fonts, and defines how all your data should be styled on your map. For more about styles, see the Styles section of the Mapbox Studio Manual.

To create a new style from your Styles page:

  1. Click New style.
  2. Scroll to the bottom of the list and select Blank, which lets you create a new style from scratch.
  3. Click Customize Blank. The style editor will automatically open.

Use the style editor

You will use the style editor to add the data you downloaded to the map and adjust the style of the country.

Add a tileset source

You can add Australia to the empty map canvas by uploading the Natural Earth data as a tileset:

  1. Click + to add a new layer.
  2. Click Upload data.
  3. Select the ZIP file with the Natural Earth data. You do not need to unzip this file before you upload it.
  4. Click Confirm. A popover in the bottom right of the screen will display the progress of your upload.
  5. Once the upload has succeeded, the tileset will be ready to use!
  6. Search for your tileset in the Source list. Click on the source, then select the source layer you want to use.

The tileset you created includes all countries. To filter to use only Australia:

  1. Click the Filter option and click + Create filter.
  2. Choose NAME from the list of data fields.
  3. Type Australia into the search bar. Click + Use Australia and then click Done.
  1. In the original panel, flip back to the Style tab.
  2. You'll see a black outline of Australia in your map canvas.

Style data

Next, click the Style tab to customize the look and feel of the layer. Change both the Color and 1px stroke fields to #11b1f0.


When you have finished editing your map style, publish your changes by clicking Publish in the upper right of the style editor. When you click the publish button, a window will display the difference between the previous and current version of this style. If you're happy with the changes, click Publish. Your style will now be available to share from a variety of tools and applications.

Final product

You've styled a single country with the help of an outside data source. Mapbox Studio provides a wide variety of ways to use your new map style. You can use this map directly on your website or in a web or mobile application. Take a look at the Publish style section of the Mapbox Studio Manual to see all the ways you can use your style!

Next steps

Learn more about what you can do with the Mapbox Studio style editor in the Mapbox Studio Manual.

Was this page helpful?