What is Closeby?

Closeby is a store and dealer locator platform built for online brands. It lets you create beautiful, embeddable store locator maps that help your customers find your products in the real world.

With Closeby you can:

Add and manage all your retail locations in one place;
Embed a fully customizable store locator on your website;
Import locations in bulk via CSV or Google Sheets;
Integrate directly with Shopify, Wix, WordPress, Squarespace, or any other platform you host your website on.

Quick Start Guide

Getting your store locator live takes just a few steps. First, create your account and set up your Mapbox access token. Then add your locations, customize your map's appearance using the Map Builder, and embed the map on your site using a simple code snippet.

Step 1: Set up your Mapbox token

Closeby uses Mapbox to power its maps and geocode your location addresses. Before adding locations, you'll need a Mapbox access token. Head to mapbox.com and create a free account. Mapbox requires a credit card on file, but their free tier is generous — you get 50,000 map loads and 100,000 geocoding requests (read: searches your users can make in the search bar) per month at no cost. Most Closeby users stay well within these limits. Once you've created your Mapbox account, copy your default public token and paste it into your Closeby settings.

Step 2: Add your locations

Navigate to the Locations tab in your dashboard. You can add locations one at a time or import them in bulk using a CSV file. Each location can include an address, phone number, business hours, categories, and images.

Step 3: Customize your map

Use the Map Builder to choose a theme, adjust colors, configure the search radius, and set up category filters. You can preview changes in real time before publishing.

Step 4: Embed on your site

Copy the embed code from the Install page and paste it into your website. Closeby supports iframe embeds, JavaScript direct embeds, and platform-specific integrations for Shopify and Wix.

Creating Your First Map

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Cras mattis consectetur purus sit amet fermentum. Nullam quis risus eget urna mollis ornare vel eu leo.

Aenean lacinia bibendum nulla sed consectetur. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Donec sed odio dui. Cras justo odio, dapibus ut facilisis in, egestas eget quam.

Plans & Pricing

Closeby offers a free trial so you can explore the platform before committing. Paid plans are based on the number of locations and monthly map views. Visit the pricing page for current plan details.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante venenatis dapibus posuere velit aliquet. Maecenas faucibus mollis interdum. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.

Adding Locations

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Bulk Import (CSV)

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam id dolor id nibh ultricies vehicula ut id elit. Cras mattis consectetur purus sit amet fermentum. Donec ullamcorper nulla non metus auctor fringilla.

Google Sheets Sync

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas sed diam eget risus varius blandit sit amet non magna. Cras mattis consectetur purus sit amet fermentum.

Categories & Filters

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum id ligula porta felis euismod semper. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Business Hours

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

General

All of the settings below can be found on the Theme Settings page in Closeby — look for the paint palette icon in the left sidebar of your dashboard. This is where you control the look, feel, and behavior of your store locator.

Full Layout

Controls the overall layout of the location list that appears alongside your map. There are three options:

Standard Location List (default) — a clean, text-based list of locations with name, address, and key details. Best for maps with many locations where scanning quickly matters.
Location & Image List — each location in the list is accompanied by its image (if one has been uploaded). This gives visitors a more visual browsing experience.
2-Column Location Image List — locations are displayed in a two-column grid with images, creating a more gallery-like feel. Works well when you have fewer locations and want to emphasize imagery. Images in this layout use a 16:9 aspect ratio when cropping is enabled.

Primary Color

Sets the main accent color used throughout your store locator. A darker shade is recommended for readability. This color is applied to location buttons and links, map markers and pins, popup highlights, and the category filter bar. You can choose from a set of preset swatches or enter a custom hex color code.

Font Family

Set a custom font for your map to match your company branding. The font you choose will be applied to all text in your store locator, including location names, addresses, details, search placeholder text, and buttons.

Button Style

Controls the shape of buttons in your store locator, including the "Get Directions" button and any custom buttons you add to your locations. There are three options:

Completely rounded buttons (default) — pill-shaped buttons with fully rounded corners.
Rectangular buttons with sharp edges — square-cornered buttons for a more angular look.
Rectangular buttons with rounded edges — a middle ground with slightly rounded corners.

Scroll Zoom & Full-Screen Viewing

Two checkboxes that control map interaction behavior:

Enable scroll zoom on my map — allows visitors to zoom in and out of the map using their trackpad or mouse scroll wheel. When disabled, users must use the zoom controls or pinch gestures instead. On mobile, two-finger gestures are always required for zooming regardless of this setting.
Enable full-screen viewing on my map — adds a full-screen button to the map that lets visitors expand the map portion to fill their entire screen.

Popup Preference

Controls what information is prioritized in the popup that appears when a visitor clicks on a location pin on the map. You can choose to prioritize:

Prioritize days open — shows the days the location is open (e.g., "Open Mon-Fri") as the most prominent detail.
Prioritize phone number — shows the location's phone number first.
Prioritize website URL — shows the location's website link first.

Showing "Get Directions" Button

Determines when the "Get Directions" button appears on your location details, particularly in relation to any custom buttons you've added to your locations. The options are:

Override direction button with custom buttons — if a location has custom buttons, the directions button will be replaced by them.
Always show directions (even if custom button added) — the directions button is always visible alongside any custom buttons.
Always hide directions (even if custom button added) — the directions button is never shown, regardless of whether custom buttons exist.

Open Custom Button Links in a New Tab

When enabled, clicking on any custom button you've added to your locations will open the link in a new browser tab instead of navigating away from the current page. This only applies when custom buttons have been added to your locations.

Enable Launcher

The launcher is a small floating button that appears in the corner of your website, allowing visitors to open your store locator in an overlay. When this is enabled, the launcher will appear automatically on pages where the Closeby embed code is installed. If you disable the launcher, you will need to manually trigger the map overlay using buttons or links on your website. For Shopify users, you must also enable the "Shopify Overlay" on your map installation settings to use the launcher. This setting is not available for Wix-connected accounts.

Launcher Text

The text displayed on the launcher button in the corner of your website. Defaults to "Our Locations". Maximum 30 characters. This setting only appears when the launcher is enabled.

Show Category Filter Bar

When enabled, a filter bar appears in your store locator that lets visitors filter locations by category. Categories must first be created and assigned to your locations for this feature to be useful. The filter bar appears above the location list and allows visitors to select one or more categories to narrow down the results.

Auto-Refresh Map Locations

By default, when a visitor moves or pans the map, Closeby shows a prompt asking the user to refresh the search area. This is considered a smoother experience for most maps because it prevents the location list from constantly updating as the user explores. When you enable auto-refresh, the location results will automatically update whenever the map is moved, without requiring the user to click anything. This can be preferable for hyper-localized maps where the area of interest is small.

Cluster Locations

When enabled, locations that are close together will be grouped into numbered clusters at lower zoom levels. As visitors zoom in, the clusters break apart into individual pins. This is particularly useful when you have many locations in a concentrated area that would otherwise overlap and be difficult to click on. Clustering is disabled at higher zoom levels where individual pins are clearly visible. Note that category-specific pin colors will not be used when locations are clustered.

Location Repositioning

When enabled, clicking on a location in the list will automatically pan and zoom the map to center on that location. This creates a "fly to" animation that smoothly repositions the map view. When disabled, clicking a location in the list will highlight it but the map position will not change.

Suggestion Range

Controls how the map responds when a visitor selects an autocomplete suggestion from the search bar:

Bounding Box (default) — the map zooms to show the full geographic bounds of the selected suggestion (e.g., the entire city or region). This lets visitors see all locations within that area.
Near Center — the map centers on the suggestion and shows all locations within a 50-mile range of that center point.

When Bounding Box is selected, an additional option appears: "Do not show nearby locations when no results are found." When enabled, if no locations exist within the bounding box area, the map will not fall back to showing nearby locations outside that area.

Distance Units

Sets whether distances shown to your visitors are displayed in miles (mi) or kilometers (km). This affects the distance labels shown next to each location in the search results (e.g., "2.5 mi" vs "4.0 km").

Hours Formatting

Controls how business hours are displayed on your store locator. Choose between 12-hour clock format (e.g., 9:00AM - 5:00PM) or 24-hour clock format (e.g., 09:00 - 17:00).

Results Limit

Sets the maximum number of location results that can be displayed in a single map view. This limit applies when there are more locations than can be shown in the visible map area, which typically happens when viewing larger areas like entire countries or continents. Options are 1,000, 3,000, 5,000, or 10,000 location results. A higher limit allows visitors to see more locations at once, but can result in slower loading times, especially on mobile devices.

Show the Summary of Locations Found

Controls whether a results summary is displayed at the bottom of the location list. When enabled, visitors will see a message like "Showing 200 within 50 mi" at the bottom of the list, giving them context about how many locations are nearby. When hidden, no summary text is shown.

Showing Closed Days

Controls how days without set business hours are displayed in the location details:

Do not show closed days — days without hours are simply omitted from the hours display.
Show days as closed when no hours set — days without hours are explicitly listed as "Closed" (or whatever text you set in the Language & Text tab).

Location Category Display

Controls whether category labels are visible when a visitor views a location's details in the store locator. When set to "Show categories when viewing location details," any categories assigned to a location will be displayed. When hidden, the categories still function for filtering purposes but are not shown in the location detail view.

Map Position & Geography

Default Map Position

Determines what the map shows when it first loads, before a visitor has searched or interacted with it. There are four options:

Show All — the map automatically zooms and positions itself to show all of your locations at once. This is a good default for businesses with locations spread across a defined region.
Geolocate — the map uses the visitor's browser location to center the map on their current position and show nearby locations. The visitor will be prompted by their browser to share their location. If they decline, the map falls back to showing all locations.
Viewport — the map opens to a specific geographic area that you define. You can search for a city, region, or country and set the exact map bounds. This is useful if you want the map to always open showing a particular area, like a specific city or state.
Specific Location — the map opens centered on one of your existing locations. You select which location from a dropdown. This is useful for businesses with a flagship or primary location they want to highlight by default.

Location Repositioning

When enabled, clicking on a location in the list will automatically pan and zoom the map to center on that location with a smooth "fly to" animation. This setting also appears on the General tab for convenience. When disabled, clicking a location in the list will highlight it and show its details, but the map position will not change.

Autocomplete Suggestions

Controls what types of geographic results appear in the search bar as visitors type. You can choose which types of places are suggested: cities, states/regions, and/or countries. For example, if your locations are all within a single city, you might want to only show city-level suggestions. If your locations span multiple countries, enabling all three types gives visitors the most flexibility.

Autocomplete Country Restriction

Restricts the search bar's autocomplete suggestions to specific countries. This is useful if you only have locations in certain countries and want to prevent visitors from searching in irrelevant regions. You can add multiple countries by selecting them from a dropdown. For example, if all your stores are in the United States and Canada, restricting to those two countries will prevent suggestions for locations in other countries. When no countries are selected, suggestions are global.

Location Images

Image Display Mode

Controls how location images are rendered in the location list and detail views. There are two options:

Crop image to fill — scales and crops images to fill a 4:3 frame (or 16:9 if you've selected the 2-Column Location Image List layout). Parts of the image that don't fit will be trimmed, but there will be no empty borders or letterboxing. This creates a uniform, consistent appearance across all locations.
Adjust the height of the image container to match image aspect ratios — images are displayed at their original aspect ratio without cropping. The container height adjusts to fit each image. Closeby recommends images slightly wider than they are tall (16:9 or 4:3 are good ratios). If you use the multiple images per location feature, all images should ideally share the same aspect ratio for the best experience.

Default Location Image

Upload a fallback image that will be used for any location that doesn't have its own image set. This ensures every location in your store locator has a visual, even if you haven't uploaded individual photos for each one. Supported formats are PNG (recommended), JPG, and JPEG. Maximum file size is 10MB.

Category Location Images

When enabled, you can upload a default image for each category. These category-specific images are used as fallback images for locations in that category when the location doesn't have its own image. This is useful if you have different types of locations (e.g., retail stores vs. warehouses vs. pop-up shops) and want each type to have a distinct default image. If a location has its own image uploaded, it will always take priority over the category default.

Mobile

Mobile Layout

Controls how the store locator is displayed on mobile devices. There are two options:

Small Map & List View (default) — shows a smaller map at the top of the screen with the location list below it. Visitors can scroll through the list without the map taking up the full viewport. This is the best option for most use cases.
Full Map & Search View — the map fills the entire mobile screen with a search bar overlaid on top. Visitors can toggle between the map view and a list view. This works well when the map itself is the primary focus and visitors are expected to search rather than browse.

Single Finger Scroll

By default, interacting with the map on a mobile device requires two fingers — one finger scrolls the page, and two fingers interact with the map. This prevents the map from "trapping" users who are trying to scroll past it on the page. When single finger scroll is enabled, visitors can interact with the map using one finger, but they will only be able to scroll the page by touching areas outside the map. Enable this if your map is the primary content on the page and visitors are unlikely to need to scroll past it.

Map Pins

Pin Style

Controls the appearance of the location markers on your map. There are three options:

Default Map Pin — the standard teardrop-shaped map marker. The pin color is determined by your primary color or by category-specific colors if enabled.
Circle Icon — a simpler circular dot marker. Like the default pin, the color is based on your primary color or category colors.
Custom Image — use your own image as the map marker. When selected, you can upload a custom marker icon image. This overrides category-specific colors (since the image itself is used), but you can still set category-specific images.

Custom Marker Icon

Upload a custom image to use as your map pin. This setting only appears when "Custom Image" is selected as the pin style. The recommended size is 60px wide by 80px tall. Supported formats are PNG (recommended), JPG, and JPEG. Maximum file size is 75KB. Using a custom marker icon will override any category-specific pin colors, since the image itself replaces the colored pin.

Cluster Locations

When enabled, nearby location pins are grouped into numbered clusters at lower zoom levels. As visitors zoom in, clusters break apart to reveal individual pins. This improves usability when you have many locations concentrated in a small area, preventing pins from overlapping and becoming unclickable. Note that category-specific pin colors and images will not be used for clustered pins — clusters always use a default style.

Pin Colors

When category-specific colors are enabled, each category can be assigned its own pin color. Location pins on the map will use the color of the first category assigned to that location. This is useful for visually distinguishing between different types of locations (e.g., blue for retail stores, green for distributors). Category colors are not applied when locations are clustered at lower zoom levels. This setting appears when using the Default Map Pin or Circle Icon pin styles.

Pin Images

When using custom image markers, you can enable category-specific images instead of category-specific colors. Each category can have its own custom marker image uploaded. Location pins on the map will use the image associated with the first category assigned to that location. Like category colors, category images are not applied when locations are clustered. This setting only appears when "Custom Image" is selected as the pin style.

Map Theme

Map Style

Choose the visual style of the underlying map. Closeby provides a selection of pre-built Mapbox map styles, each with a different visual aesthetic — from clean and minimal to detailed and topographic. The style you choose affects the colors, labels, and level of detail shown on the map itself (roads, parks, water, buildings, etc.). Select the style that best matches your brand's visual identity.

Custom Mapbox Style

If none of the pre-built styles match your needs, you can use your own custom Mapbox style. Create a style in Mapbox Studio, copy the Style URL (which starts with "mapbox://styles/..."), and paste it into this field. This gives you complete control over every visual element of the map, from road colors to label fonts. This option is only available if you've connected your own Mapbox access token (the token must be a public key starting with "pk."). Once a custom style URL is entered, click "Enable Style" to apply it.

Language & Text

The Language & Text tab lets you override all user-facing text labels in your store locator. This is essential for localizing your map into different languages or simply adjusting the default wording to match your brand's tone. Every text field has a character limit to ensure the UI remains clean.

Search Placeholder

The placeholder text shown inside the map's search box before a visitor starts typing. Defaults to "Search...". Maximum 30 characters. You might change this to something more specific like "Find a store near you" or localize it to another language.

Filters Options

The label shown for the category filter bar (if category filtering is enabled). Defaults to "Filter Locations". Maximum 30 characters.

No Locations Found

The message displayed to visitors when their search returns no results. This uses a rich text editor, so you can apply bold, italic, underline, strikethrough formatting, adjust text alignment, add lists, and include links. Use this to provide helpful guidance, such as suggesting the visitor try a broader search or linking to a contact page.

Locations Limit

The message shown when more locations exist than can be displayed in the current view. For example, "Showing 200 of 621 locations. Zoom in or use the search bar to see more locations." This field lets you customize the instructional text that follows the count. Maximum 80 characters.

Location Website Link

The text displayed as the clickable link when a location has a URL set. Defaults to "Visit Website". Maximum 80 characters. You might change this to "View Store Page", "Shop Now", or a localized equivalent.

Directions Button

The text displayed on the button that links to directions for a location. Defaults to "Get Directions". Maximum 20 characters. The button automatically generates a link to Google Maps or Apple Maps directions to the location's address.

Refresh Search

The text on the link that appears after a visitor moves the map, prompting them to refresh the location results for the new area. Defaults to "Search this area". Maximum 30 characters. This link only appears when auto-refresh is disabled.

Open 24 Hours

The text displayed when a location is marked as open 24 hours. Defaults to "Open 24 hours". Maximum 30 characters.

Day Names

Customize the labels for each day of the week as they appear in the business hours display. Each day has two fields: a full name (e.g., "Monday", max 20 characters) and a short name (e.g., "Mon", max 6 characters). The short name is used in compact views like the map popup, while the full name is used in the expanded location details. This is particularly useful for localizing your map — for example, setting Monday to "Lundi" / "Lun" for French.

Closed Day Text

The text shown for days when a location has no hours set and "Show days as closed" is enabled in the General tab. Defaults to "Closed". Maximum 15 characters.

Open Hours Day Range

Controls the text used when displaying a range of open days. For example, in "Open Mon-Fri", the word "Open" and the separator between days can be customized. The first field is the prefix (defaults to "Open", max 7 characters) and the second is the range separator (defaults to "to", max 4 characters). So "Monday to Friday" could become "Abierto Lunes a Viernes" in Spanish.

Mobile List Toggles

The text on the buttons that let mobile visitors switch between the map view and the list view. Only applicable when "Full Map & Search View" is selected as the mobile layout. There are two fields: one for showing the list (defaults to "Show List", max 12 characters) and one for returning to the map (defaults to "View Map", max 12 characters).

Advanced Styles

The Advanced Styles tab provides fine-grained color control over individual elements of your store locator using color pickers. These settings override the defaults set by your primary color and map theme. Note that changes made here may be more difficult to revert — you can use the reset link at the top of this tab to restore all advanced styles to their default values.

Locations List Background

The background color of the entire locations list panel. By default this is white. Changing it affects the area behind all location cards in the list.

Button Text Color

The text color used inside location buttons, including the "Get Directions" button and any custom buttons. By default, button text is white on the primary color background.

Popup Text Color

The text color used in map popups that appear when a visitor clicks on a location pin. This affects all text within the popup, including the location name, address, and details.

Location Title Color

The color of the location name as it appears in both the full location list and the location detail view. Use this to make location names stand out or match your brand.

Location Subtitle Color

The color of the location address text shown below the location name in both the list and detail views.

Location Details Color

The text color for location hours, phone numbers, and other additional details shown in the location detail view.

Filters Background

The background color of the category filter bar. By default, this matches the location list background.

Filters Placeholder Color

The text color of the filter bar's empty/default state text before any filters are selected.

Filters Selected Icon Color

The color of the icon (checkmark or indicator) shown on filters that have been selected by the visitor.

Search Text Color

The color of text that visitors type into the autocomplete search bar.

Search Icon Color

The color of the search icon (magnifying glass) displayed in the search bar.

Search Placeholder Color

The color of the placeholder text shown in the search bar before a visitor starts typing (e.g., "Search...").

Search Input Background

The background color of the search bar input field.

User Location Icon Color

The color of the dot that indicates the visitor's current location on the map. This icon only appears when the default map position is set to "Geolocate" and the visitor has shared their browser location.

Map Builder

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris.

Embed Options

Closeby provides several ways to add the store locator to your website:

iFrame Embed — the simplest option, works on any website;
JavaScript Embed — more flexible, allows deeper customization;
Platform Integrations — native integrations for Shopify and Wix.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras mattis consectetur purus sit amet fermentum. Maecenas faucibus mollis interdum.

Shopify

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean lacinia bibendum nulla sed consectetur. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.

Wix

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras justo odio, dapibus ut facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.

WordPress

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo.

Squarespace

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh.