---
title: "Change the case of labels | JavaScript maps SDK"
description: "Modify label text casing using upcase and downcase expressions."
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# Change the case of labels

Use the [`upcase`](https://docs.maptiler.com/gl-style-specification/expressions/#upcase) and [`downcase`](https://docs.maptiler.com/gl-style-specification/expressions/#downcase) expressions to change the case of labels.

### NPM module setup

```bash
npm install --save @maptiler/sdk
```

#### main.js

```js
import { Map, MapStyle, config } from '@maptiler/sdk';
import '@maptiler/sdk/dist/maptiler-sdk.css';

config.apiKey = 'YOUR_MAPTILER_API_KEY_HERE';
const map = new Map({
    container: 'map', // container id
    style: MapStyle.STREETS,
    center: [-116.231, 43.604], // starting position [lng, lat]
    zoom: 11 // starting zoom
});

map.on('load', function () {
    // data from opendata.cityofboise.org/
    map.addSource('off-leash-areas', {
        'type': 'geojson',
        'data':
            'https://docs.maptiler.com/sdk-js/assets/boise.geojson'
    });
    map.addLayer({
        'id': 'off-leash-areas',
        'type': 'symbol',
        'source': 'off-leash-areas',
        'layout': {
            'icon-image': 'dog-park-11',
            'text-field': [
                'format',
                ['upcase', ['get', 'FacilityName']],
                { 'font-scale': 0.8 },
                '\n',
                {},
                ['downcase', ['get', 'Comments']],
                { 'font-scale': 0.6 }
            ],
            'text-font': ['Open Sans Semibold', 'Arial Unicode MS Bold'],
            'text-offset': [0, 0.6],
            'text-anchor': 'top'
        }
    });
});
```

#### index.html

```html
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="robots" content="noindex">
  <title>Change the case of labels | NPM example</title>
  <link rel="stylesheet" href="./style.css">
</head>
<body>
  <div id="map"></div>
  <script type="module" src="./main.js"></script>
</body>
</html>
```

#### style.css

```css
body {margin: 0; padding: 0;}
#map {position: absolute; top: 0; bottom: 0; width: 100%;}
```

### Basic JavaScript setup

```html
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Change the case of labels</title>
<script src="https://cdn.maptiler.com/maptiler-sdk-js/v4.2.0/maptiler-sdk.umd.min.js"></script>
<link href="https://cdn.maptiler.com/maptiler-sdk-js/v4.2.0/maptiler-sdk.css" rel="stylesheet" />
<style>
  body {margin: 0; padding: 0;}
  #map {position: absolute; top: 0; bottom: 0; width: 100%;}
</style>
</head>
<body>
<div id="map"></div>
<script>
    maptilersdk.config.apiKey = 'YOUR_MAPTILER_API_KEY_HERE';
    const map = new maptilersdk.Map({
        container: 'map', // container id
        style: maptilersdk.MapStyle.STREETS,
        center: [-116.231, 43.604], // starting position [lng, lat]
        zoom: 11 // starting zoom
    });

    map.on('load', function () {
        // data from opendata.cityofboise.org/
        map.addSource('off-leash-areas', {
            'type': 'geojson',
            'data':
                'https://docs.maptiler.com/sdk-js/assets/boise.geojson'
        });
        map.addLayer({
            'id': 'off-leash-areas',
            'type': 'symbol',
            'source': 'off-leash-areas',
            'layout': {
                'icon-image': 'dog-park-11',
                'text-field': [
                    'format',
                    ['upcase', ['get', 'FacilityName']],
                    { 'font-scale': 0.8 },
                    '\n',
                    {},
                    ['downcase', ['get', 'Comments']],
                    { 'font-scale': 0.6 }
                ],
                'text-font': ['Open Sans Semibold', 'Arial Unicode MS Bold'],
                'text-offset': [0, 0.6],
                'text-anchor': 'top'
            }
        });
    });
</script>
</body>
</html>
```

## Related examples

### [Icon image URL inside a rich text format label](https://docs.maptiler.com/sdk-js/examples/rich-text-format/)

Examples

Display rich text labels with texts and icons.

### [Display and style rich text labels](https://docs.maptiler.com/sdk-js/examples/display-and-style-rich-text-labels/)

Examples

Display multilingual rich text labels using format expressions.

### [Set map language](https://docs.maptiler.com/sdk-js/examples/language-map/)

Tutorials

This tutorial shows how to change the default map labels language.

### [Add a stretchable image to the map](https://docs.maptiler.com/sdk-js/examples/add-image-stretchable/)

Examples

Use stretchable images as background for map text labels.
