Dealer Locator

Version v1.0.0
Platform Magento 2
Module Released 18 November 2026

Manage Dealers & Product Categories | Magento 2

Looking for Dealer Locator? View the full Dealer Locator page to explore features, configuration options, and pricing.

This guide covers the two admin screens of the Dealer Locator where you do the day-to-day work: the dealer grid with its edit form, and the product category grid. You'll find what each column means, how to filter for dealers that aren't on the map yet, what the mass actions do, how map coordinates are filled in when you save, and how to translate category names per store view. It also explains which dealers end up on the storefront, so you know why a dealer is or isn't visible to your customers. For adding many dealers at once, see the import guide instead.

Where to Find It

Navigate to: Content → Dealer Locator

  • Dealers - all dealers, with add, edit, import and mass actions
  • Product Categories - the categories visitors can filter on
  • Configuration - shortcut to the module settings

Your Magento admin role needs the matching permissions under Content → Dealer Locator: Dealers (view), Save Dealers, Delete Dealers, Import Dealers and Product Categories. Buttons and actions you don't have permission for are hidden.

How Dealers Appear on the Storefront

A dealer is shown on the dealer locator page when all of these are true:

  • Active is on
  • It's assigned to the store view the visitor is on, or to All Store Views
  • It has coordinates (latitude and longitude), so it can be placed on the map

Dealers without coordinates stay in the admin, but aren't shown: without a location they can't appear on the map or be sorted by distance. The On Map column shows which dealers this concerns.

Changes are visible on the storefront straight after saving; the page cache for the dealer page is refreshed automatically.

The Dealer Grid

Columns

Column What it shows
ID Internal number
Code Your unique reference for the dealer, also used by the CSV import
Name Dealer name as shown to visitors
Street, Postcode, City, Country The address
On Map Yes when the dealer has coordinates, No when it can't be shown yet
Product Categories The categories the dealer sells
Store View Where the dealer is shown
Active Whether the dealer is shown at all
Phone, Website, Modified Hidden by default; switch them on with Columns

Searching and Filtering

  • The search box searches code, name, street, postcode and city.
  • Filters adds filters per column, plus Store View (dealers for "All Store Views" are included in every store view) and Product Category.

Tip: Filter on On Map: No to find the dealers whose address couldn't be found. Fix the address, or use the Find Location action.

Mass Actions

Select dealers with the checkboxes, then choose an action:

  • Activate / Deactivate - show or hide the selected dealers on the storefront. This doesn't look up coordinates.
  • Find Location - looks up coordinates for the selected dealers that don't have them yet. Dealers that already have coordinates are skipped. With OpenStreetMap this takes about one second per dealer and stops after 60 seconds; run it again for the rest.
  • Delete - permanently deletes the selected dealers.

If a dealer can't be updated, the others still are; the messages list which dealers failed and why.

Toolbar Buttons

  • Download Sample CSV and Import CSV - see the import guide
  • Add New Dealer - opens an empty dealer form

The Dealer Form

General

  • Active - shown on the storefront or not
  • Code - a unique reference, such as your customer number for the dealer. Letters, digits, "-", "_" and "." only. The CSV import uses it to recognise existing dealers, so keep it stable.
  • Name - as shown to visitors

Address and Location

  • Street and Number, Postcode, City, Country
  • Latitude / Longitude - the position on the map

When you save, the module fills in the coordinates for you:

  • Leave latitude and longitude empty: they're looked up from the address. The message after saving shows the coordinates that were found.
  • Enter them yourself: your coordinates are kept, also when you change the address in the same save. Useful when the shop entrance is somewhere else than the address suggests.
  • Change the address later without touching the coordinates: they're looked up again, so the pin moves with the address.

A postcode or city is needed for a lookup. If the address can't be found, you get a warning and the dealer is saved without moving the pin. With Google Maps, an address that only roughly matches (for example only the postcode area) also counts as not found; the warning then shows Google's closest match. Check the address, or enter the coordinates by hand (for example copied from a map service: right-click the location and copy the two numbers).

You can type coordinates with a decimal comma or point: 52,0907 and 52.0907 both work.

Contact

  • Phone - shown as a link that starts a call on mobile
  • Website - the full address including https://; opens in a new tab and is marked "nofollow" for search engines

Product Categories and Store Views

  • Product Categories - what this dealer sells; visitors can filter on them
  • Store Views - where the dealer is shown. Hidden when your Magento runs in single-store mode.

The Product Category Grid

Navigate to: Content → Dealer Locator → Product Categories

Column What it shows
Default Label The name of the category
Sort Order Lower numbers come first in the storefront filter
Store View Labels Translations per store view
Dealers How many dealers have this category

Click Default Label or Sort Order in a row to edit them right in the grid; click Save in the row to store the change. Use Edit for the full form.

The Category Form

  • Default Label - shown in every store view without its own label
  • Sort Order - position in the filter
  • Labels per Store View - one field per store view; leave a field empty to use the default label there

Deleting a category removes it from all dealers. The dealers themselves stay.

The category filter is only shown on the storefront when the dealers on the page use at least two categories.

Need More Help?

Documentation:

Support:

For a complete overview of features and configuration options, see Dealer Locator.

Article Updated:
Download PDF
star star star star star
star star star star star
Gaaf - digital agency
We have tried the integration with SnelStart through several different providers, and this is the only solution that simply works. We needed support on two occasions, and it was provided quickly and professionally. We do recommend this company!
Google 12 May 2026
star star star star star
star star star star star
Andrew Velikiy
Great vendor with handy modules and quick support!
Google 13 Apr 2026
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025