Skip to main content

Customize label text for a single label

This tutorial will walk you through how to use expressions in the Mapbox Studio style editor to customize the label text for a single label.

Getting started

Before getting started, you will need to create a Mapbox account to 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 your map on the page. It defines how all your data should be styled and includes references to your data and map images (icons, markers, patterns), fonts. For more about styles, see the Styles section of the Mapbox Studio Manual.

Go to your Styles page. Click the New style button. Find the Basic Template style and click Customize Basic. The style editor will automatically open with the Basic template style ready for editing.

Use the style editor

The Mapbox Studio style editor is a visual tool for creating custom map styles to your exact specifications. Take a look at the layers on the left side of the style editor screen. Each layer can be customized in a variety of ways including (but not limited to) changing labels.

Adjust Place labels component

In the Components tab, click on Place labels. This will open a component property panel that lists all the available properties for this component. Since you'll be focused on customizing country labels, start by hiding other place labels:

  1. Toggle the States property off.
  2. Toggle the Settlements property off.
  3. Toggle the Settlement subdivisions property off.

Set a manual override

If a layer property is controlled by a component, a lock lock icon will appear next to the value. You can override any layer property controlled by a component by clicking the Override button.

  1. Switch to the Layers tab.
  2. Click on the country-label layer.
  3. Click on the Text field property.
  4. Click Override to unlock all style options available for the Text field property.

Use expressions to edit specific labels within a layer

Click on the country-label layer to see all the options available to style this layer. To customize the country labels based on conditions and properties within the data, select Style with data conditions and choose name_en to style the label based on the English name for the country.

In the new panel, you are prompted to fill in the details of your data condition. In the first text field, enter France since this is the label you will be customizing. In the Text field, add "Land in: " and click on & to combine your two strings. As you do this, you will see the France label change to Land in: France on your map.

To edit another data condition, click Done in the bottom right hand corner and then Add another condition. This time, continue the travel journey by choosing the first stop on the trip. In the first text field, enter Spain and then "First stop: " in the Text field box.

Repeat the previous step to continue to add more data conditions and stops on the trip. Once you are finished your map will look something like the one below.

Final product

You've updated your map using expressions to display custom labels for specific labels. To learn more about using the Mapbox Studio style editor, read the Mapbox Studio Manual.

Was this page helpful?