---
title: "Filter symbols by text input | JavaScript maps SDK"
description: "Filter symbols by typing names into a text input."
---

> 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.

# Filter symbols by text input

Filter [symbols](https://docs.maptiler.com/gl-style-specification/layers/#symbol) by icon name by typing in a text input.

### 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 places = {
    'type': 'FeatureCollection',
    'features': [
        {
            'type': 'Feature',
            'properties': {
                'icon': 'theatre'
            },
            'geometry': {
                'type': 'Point',
                'coordinates': [-77.038659, 38.931567]
            }
        },
        {
            'type': 'Feature',
            'properties': {
                'icon': 'theatre'
            },
            'geometry': {
                'type': 'Point',
                'coordinates': [-77.003168, 38.894651]
            }
        },
        {
            'type': 'Feature',
            'properties': {
                'icon': 'bar'
            },
            'geometry': {
                'type': 'Point',
                'coordinates': [-77.090372, 38.881189]
            }
        },
        {
            'type': 'Feature',
            'properties': {
                'icon': 'bicycle'
            },
            'geometry': {
                'type': 'Point',
                'coordinates': [-77.052477, 38.943951]
            }
        },
        {
            'type': 'Feature',
            'properties': {
                'icon': 'music'
            },
            'geometry': {
                'type': 'Point',
                'coordinates': [-77.031706, 38.914581]
            }
        },
        {
            'type': 'Feature',
            'properties': {
                'icon': 'music'
            },
            'geometry': {
                'type': 'Point',
                'coordinates': [-77.020945, 38.878241]
            }
        },
        {
            'type': 'Feature',
            'properties': {
                'icon': 'music'
            },
            'geometry': {
                'type': 'Point',
                'coordinates': [-77.007481, 38.876516]
            }
        }
    ]
};

const layerIDs = []; // Will contain a list used to filter against.
const filterInput = document.getElementById('filter-input');
const map = new Map({
    container: 'map',
    style: MapStyle.STREETS, 
    center: [-77.04, 38.907],
    zoom: 11.15
});

map.on('load', function () {
    // Add a GeoJSON source containing place coordinates and information.
    map.addSource('places', {
        'type': 'geojson',
        'data': places
    });

    places.features.forEach(function (feature) {
        const symbol = feature.properties['icon'];
        const layerID = 'poi-' + symbol;

        // Add a layer for this symbol type if it hasn't been added already.
        if (!map.getLayer(layerID)) {
            map.addLayer({
                'id': layerID,
                'type': 'symbol',
                'source': 'places',
                'layout': {
                    'icon-image': symbol,
                    'icon-overlap': 'always',
                    'text-field': symbol,
                    'text-font': [
                        'Open Sans Bold',
                        'Arial Unicode MS Bold'
                    ],
                    'text-size': 11,
                    'text-transform': 'uppercase',
                    'text-letter-spacing': 0.05,
                    'text-offset': [0, 1.5]
                },
                'paint': {
                    'text-color': '#202',
                    'text-halo-color': '#fff',
                    'text-halo-width': 2
                },
                'filter': ['==', 'icon', symbol]
            });

            layerIDs.push(layerID);
        }
    });

    filterInput.addEventListener('keyup', function (e) {
        // If the input value matches a layerID set
        // it's visibility to 'visible' or else hide it.
        const value = e.target.value.trim().toLowerCase();
        layerIDs.forEach(function (layerID) {
            map.setLayoutProperty(
                layerID,
                'visibility',
                layerID.indexOf(value) > -1 ? 'visible' : 'none'
            );
        });
    });
});
```

#### index.html

```html
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="robots" content="noindex">
  <title>Filter symbols by text input | NPM example</title>
  <link rel="stylesheet" href="./style.css">
</head>
<body>
  <style>
  .filter-ctrl {
      position: absolute;
      top: 10px;
      left: 10px;
      z-index: 1;
  }

  .filter-ctrl input[type='text'] {
      font: 12px/20px 'Helvetica Neue', Arial, Helvetica, sans-serif;
      width: 100%;
      border: 0;
      background-color: #fff;
      margin: 0;
      color: rgba(0, 0, 0, 0.5);
      padding: 10px;
      box-shadow: 0 0 0 2px rgba(0, 0, 0, 0.1);
      border-radius: 3px;
      width: 180px;
  }
  </style>
  <div id="map"></div>
  <div class="filter-ctrl">
  <input
      id="filter-input"
      type="text"
      name="filter"
      placeholder="Filter by name"
  />
  </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>Filter symbols by text input</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%;
    }

    .filter-ctrl {
      position: absolute;
      top: 10px;
      left: 10px;
      z-index: 1;
    }

    .filter-ctrl input[type='text'] {
      font: 12px/20px 'Helvetica Neue', Arial, Helvetica, sans-serif;
      width: 100%;
      border: 0;
      background-color: #fff;
      margin: 0;
      color: rgba(0, 0, 0, 0.5);
      padding: 10px;
      box-shadow: 0 0 0 2px rgba(0, 0, 0, 0.1);
      border-radius: 3px;
      width: 180px;
    }
  </style>
</head>

<body>
  <div id="map"></div>
  <div class="filter-ctrl">
    <input id="filter-input" type="text" name="filter" placeholder="Filter by name" />
  </div>

  <script>
    maptilersdk.config.apiKey = 'YOUR_MAPTILER_API_KEY_HERE';
    const places = {
      'type': 'FeatureCollection',
      'features': [
        {
          'type': 'Feature',
          'properties': {
            'icon': 'theatre'
          },
          'geometry': {
            'type': 'Point',
            'coordinates': [-77.038659, 38.931567]
          }
        },
        {
          'type': 'Feature',
          'properties': {
            'icon': 'theatre'
          },
          'geometry': {
            'type': 'Point',
            'coordinates': [-77.003168, 38.894651]
          }
        },
        {
          'type': 'Feature',
          'properties': {
            'icon': 'bar'
          },
          'geometry': {
            'type': 'Point',
            'coordinates': [-77.090372, 38.881189]
          }
        },
        {
          'type': 'Feature',
          'properties': {
            'icon': 'bicycle'
          },
          'geometry': {
            'type': 'Point',
            'coordinates': [-77.052477, 38.943951]
          }
        },
        {
          'type': 'Feature',
          'properties': {
            'icon': 'music'
          },
          'geometry': {
            'type': 'Point',
            'coordinates': [-77.031706, 38.914581]
          }
        },
        {
          'type': 'Feature',
          'properties': {
            'icon': 'music'
          },
          'geometry': {
            'type': 'Point',
            'coordinates': [-77.020945, 38.878241]
          }
        },
        {
          'type': 'Feature',
          'properties': {
            'icon': 'music'
          },
          'geometry': {
            'type': 'Point',
            'coordinates': [-77.007481, 38.876516]
          }
        }
      ]
    };

    const layerIDs = []; // Will contain a list used to filter against.
    const filterInput = document.getElementById('filter-input');
    const map = new maptilersdk.Map({
      container: 'map',
      style: maptilersdk.MapStyle.STREETS,
      center: [-77.04, 38.907],
      zoom: 11.15
    });

    map.on('load', function () {
      // Add a GeoJSON source containing place coordinates and information.
      map.addSource('places', {
        'type': 'geojson',
        'data': places
      });

      places.features.forEach(function (feature) {
        const symbol = feature.properties['icon'];
        const layerID = 'poi-' + symbol;

        // Add a layer for this symbol type if it hasn't been added already.
        if (!map.getLayer(layerID)) {
          map.addLayer({
            'id': layerID,
            'type': 'symbol',
            'source': 'places',
            'layout': {
              'icon-image': symbol,
              'icon-overlap': 'always',
              'text-field': symbol,
              'text-font': [
                'Open Sans Bold',
                'Arial Unicode MS Bold'
              ],
              'text-size': 11,
              'text-transform': 'uppercase',
              'text-letter-spacing': 0.05,
              'text-offset': [0, 1.5]
            },
            'paint': {
              'text-color': '#202',
              'text-halo-color': '#fff',
              'text-halo-width': 2
            },
            'filter': ['==', 'icon', symbol]
          });

          layerIDs.push(layerID);
        }
      });

      filterInput.addEventListener('keyup', function (e) {
        // If the input value matches a layerID set
        // it's visibility to 'visible' or else hide it.
        const value = e.target.value.trim().toLowerCase();
        layerIDs.forEach(function (layerID) {
          map.setLayoutProperty(
            layerID,
            'visibility',
            layerID.indexOf(value) > -1 ? 'visible' : 'none'
          );
        });
      });
    });
  </script>
</body>

</html>
```

## Related examples

### [Filter symbols by toggling a list](https://docs.maptiler.com/sdk-js/examples/filter-markers/)

Examples

Filter symbols based on property values in the dataset.

### [Point filtering by property](https://docs.maptiler.com/sdk-js/examples/point-filtering/)

Examples

Filter features in real time by property.

### [Geocoding search for POIs near the user's location](https://docs.maptiler.com/sdk-js/examples/geocoding-filter-types/)

Examples

Filter geocoding search results by specific place types.

### [Countries filter](https://docs.maptiler.com/sdk-js/examples/countries-filter/)

Tutorials

Filter MapTiler Countries data to create choropleth maps.