Configuration and Use

Signing up for Bullseye for your Magento Site

Please follow this link to sign up.  Once you sign up, go Settings>Account in your Bullseye account and find your API and Client ID:

Loading Sample Data

Note that your location data will be maintained in your Bullseye account, not your Magento login.

If you are signing up for a trial and would like to load sample data, you can download it here and go to the Bullseye admin to import the sample data (see screenshot below). If you would like to import your own data initially, please see Upload Locations in a .csv file

Configure Basic API Settings

Navigate to

Stores>Configuration>Bullseye>Store Locator>General

Copy and Paste the API key and Client ID into the appropriate fields:

Other General Settings

Top Link Text:

This will show the text of the link of the Mini Locator in the front end.  Typically depending on your theme that is on the top right of the browser.

Store Link Icon:

This will show the icon next to the link on the Top Links.

CMS Page:

This is where you can select what CMS Page the store location page uses.  You will need to go to the Bullseye application and login, and create a search interface, then go to Magento and paste that into source view of the CMS Page editor.  Remember to use source view.

The installer creates a page "\locations" that can be edit in the Magento CMS Page section of Magento.  You can find web based instructions here.

Text for Front End

This section allows you to rewrite the default text used in the mini locator and elsewhere.  For example, if you refer to your stores as dealers, you can change that here.

Creating a Widget

Currently we can support 2 different store locator widgets with your Magento site.  This allows you to display locators on specific pages, or to embed in CMS pages and blocks. Please consult the Magento documentation for more detailed instructions on Widgets.  Below is an overview of the 2 Bullseye Widgets:

  • My Nearest Locations: A map-based locator with an accompanying list.  Most often configured as a radius based search:

  • My Store: A locator that is launched from a site's navigation, allows a user to select a default store, and links to the "My Nearest Locations" locator:

Creating a Widget

  1. Go To Content>Widgets then select Add Widget.
  2. Select the "My Nearest Locations" widget
  3. Set the Storefront Properties and Options as appropriate:

Save and Clear Caches

Including a Widget in a Block or CMS Page

  1. From the CMS page WYSIWYG editor click the Insert Widget button.
  2. Select either the "My Store" or "My Nearest Locations" widget.
  3. Choose the desired options and select "Insert Widget."

Finding the Store

Click on the "Store Locator" link in the top navigation:

A popup will appear with a search box to find a store:


  1. Use My Location: This button is used to get the list of stores near the user based on the location of the user's computer or phone.  This only works if you have the widget installed on a secure site (https://).  The user may select "Allow access browser location" if they want to allow the widget to access their location on their computer or phone:

        2. Search stores on map: This will take the user to the CMS page where you have put the "My Nearest Location" interface (the code you inserted from the                     Bullseye Admin.

        3. Find a Store near a Zip/Postal Code allows the user to enter a zip code to find locations near them:

Save Store & Display Your Store in Map

The user can click the "Save" link next to the location they want to save.  This location will be displayed when they return to your site in the future, beneath the heading "Your Preferred Store."  This will remain until the user changes or removes the store. 

NOTE: The Map for the saved store and nearest store will be shown only in a secure site.

The Map view of the saved store and nearest store can be saved in any page by creating the widget as mentioned in above "Creating Widget point:

If the user has their location service turned off in their browser, or on their phone, the nearest store will not be available in map and list view, and the message will be displayed:

If the site is not secure, then both the map view and list view will not display:

If a custom logs in to the site, a "My Store" link will be created in their account navigation section, and the store can be viewed there: