All docsHelpTutorialsStyle a single country

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

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

Use the style editor to add the Mapbox Countries tileset and adjust the style of the country.

Add a tileset source

You can add Australia to the empty map canvas by using the country polygons from the Mapbox Countries tileset:

  1. In the Layers tab, click +.
  2. Click the Source drop-down menu to access the list of data sources. Search for Mapbox Countries in the Filter by name box or type in the add tileset by ID finder.
  3. Select the country_boundaries polygon layer in the Mapbox Countries tileset as the data source.
  4. Click on the shapes of various countries to understand the available data fields and values in the tileset

The Mapbox Countries tileset includes polygons for all countries of the world. To filter to use only Australia, add a filter for any of the unique data field values for Australia. We will use the English name name_en field for our filter.

  1. Click the Filter option and click + Create filter.
  2. Choose name_en 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 shape of Australia in your map canvas. Black is the default fill color.

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: Add additional geometries

You can extend the workflow outlined in this tutorial to add and style additional geometries in Mapbox Studio.

  1. Click Filter, then click the + Add another condition button.
  2. Select the name_en data field.
  3. Type in the name of the value or values you want to add. For this example, add the values Indonesia, Papua New Guinea, and Solomon Islands to select those countries.
  4. After you have added all the country names, click the Done button.
  5. Click on the Style tab, then select Style with data conditions.
  6. Select the name_en data field. Type in the value Solomon Islands.
  7. Change the hex color value to #6234df. Click the Done button.
  8. Click + Add another condition. Following the previous two steps, add a new hex color value for each of the other countries:
  • Indonesia: #56f084
  • Papua New Guinea: #f056a1You can repeat this process using any filterable data from the tileset you are using.

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