Geolocation | Yext Hitchhikers Platform

Check out this Storybook to visualize and test this component.

<Geolocation /> displays the location information that the SearchHeadless state is using to influence search results. If you scroll to the bottom of a Google search page, you’ll see an example of location bias in search.

location bias google example

Search UI React will use IP device location by default. However, the <Geolocation /> component allows the user to update the SearchHeadless state to use their HTML5 location if they click on the “Update your location” button. Clicking the <Geolocation /> button will set a static filter on builtin.location under the hood.

Here’s what <Geolocation /> looks like placed below <VerticalResults />:

Basic Example

It’s a common UX practice to place the <Geolocation /> component under the <UniversalResults /> or <VerticalResults /> like below:

import {
  SearchBar,
  StandardCard,
  VerticalResults,
  Geolocation,
} from "@yext/search-ui-react";
import { useSearchActions } from "@yext/search-headless-react";
import { useEffect } from "react";

const App = (): JSX.Element => {
  const searchActions = useSearchActions();

  useEffect(() => {
    searchActions.setVertical("locations");
  }, []);

  return (
    <div className="flex justify-center px-4 py-6">
      <div className="w-full max-w-5xl">
        <SearchBar />
        <VerticalResults CardComponent={StandardCard} />
        <Geolocation />
      </div>
    </div>
  );
};

export default App;

Customizations

Like the rest of our components, you can customize the elements of <Geolocation /> using the customCssClasses prop.

Text Styling

Adding the following styling change how the text appears in the component:

<Geolocation
  customCssClasses={{
    button: "font-semibold text-blue-500",
  }}
/>

Component API

Check out the component properties in the Search UI React Github repo .

Back

< StaticFilters

LocationBias (Deprecated) >

<% elem.innerText %>