Skip to main content

Geocoding - React Quickstart

Mapbox Geocoding provides a convenient way to leverage the Mapbox Geocoding API in a web or Node environment. Create interactive, powerful search sessions enabling users to search for address and places.

Easy-to-use UI components can be dropped into websites as standalone elements or as part of a comprehensive map experience.

This Quickstart Guide will help you get started with Geocoding using the Mapbox Search JS React framework.

To use Geocoding in a website (without React), see the Geocoding Web Quickstart.


To use Mapbox Search JS, you need to have a Mapbox access token.

Your default public token

You can use your default public token to get started with the code snippets in this guide.

To get your default public token, login to and scroll down to the Access Tokens section.

This access token associates your search requests with a Mapbox account for billing. For more information on creating and using access tokens, see our token management documentation.


Install the NPM package.

npm install --save @mapbox/search-js-react

Once installed, the Geocoder component will be available for import into your React app.

Use the Geocoder component

Add the Geocoder component wherever you need an interactive geocoding input. Be sure to pass in your Mapbox access token as the prop accessToken, and any other configuration you may need. For the full list of props, see GeocoderProps in the React reference.

import { Geocoder } from '@mapbox/search-js-react';

const MyComponent = () => {
return (
language: 'en',
country: 'US'

export default MyComponent

Autofill Checkout (React) example

Try a full address autofill workflow in React, including address confirmation and minimap.


Integration with a Mapbox GL JS Map

The <Geocoder> component can be used in a standalone fashion, but a common use case is to zoom to a location on a map and show a marker pin after the user chooses a result. <Geocoder> includes convenient configuration options for binding with a Mapbox GL JS Map instance to achieve this functionality.

The map prop binds to the Map instance, and the props mapboxgl and marker are used to create the Marker.

import { useRef, useEffect, useState } from "react";
import { Geocoder } from "@mapbox/search-js-react";
import mapboxgl from "mapbox-gl";
import "mapbox-gl/dist/mapbox-gl.css";

const accessToken = "YOUR_MAPBOX_ACCESS_TOKEN";

export default function MapWithGeocoder() {
const mapContainerRef = useRef();
const mapInstanceRef = useRef();
const [, setMapLoaded] = useState(false);
const [inputValue, setInputValue] = useState("");
useEffect(() => {
mapboxgl.accessToken = accessToken;

mapInstanceRef.current = new mapboxgl.Map({
container: mapContainerRef.current, // container ID
center: [-74.5, 40], // starting position [lng, lat]
zoom: 9, // starting zoom

mapInstanceRef.current.on("load", () => {
}, []);

return (
onChange={(d) => {
<div id="map-container" ref={mapContainerRef} style={{ height: 300 }} />

Additional Resources

Quickstart Guides are also available for the other main features of Mapbox Search JS:

Geocoding can also be implemented with a custom UI by using the Mapbox Search JS Core Framework.

Was this page helpful?