---
title: "Change a map's language | JavaScript maps SDK"
description: "Use setLanguage function to switch languages dynamically."
---
> 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 a map’s language
You can utilize the [`setLanguage`](https://docs.maptiler.com/sdk-js/api/map/#map#setLanguage) function to dynamically switch between languages. This function allows you to modify the language setting for the labels that appear on maps. By following these guidelines, users can customize the language of map labels based on their personal preferences.
### 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',
style: MapStyle.BASE,
center: [16.05, 48],
zoom: 2.9
});
document
.getElementById('buttons')
.addEventListener('click', function (event) {
const language = event.target.id;
map.setLanguage(maptilersdk.Language[language]);
});
```
#### index.html
```html
Change a map's language | NPM example
French
Russian
German
Spanish
```
#### style.css
```css
body {margin: 0; padding: 0;}
#map {position: absolute; top: 0; bottom: 0; width: 100%;}
```
### Basic JavaScript setup
```html
Change a map's language
French
Russian
German
Spanish
```
## Related examples
### [Map language by IP](https://docs.maptiler.com/sdk-js/examples/ip-map-language/)
Tutorials
This tutorial shows how to automatically change the map labels language based on visitor's location usign the MapTiler Geolocation API.
### [Geocoding language](https://docs.maptiler.com/sdk-js/examples/geocoding-language/)
Examples
Specify languages for geocoding response text and query weighting.
### [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.