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:
- All Help Articles - Complete documentation overview
Support:
- Contact Support - Get help from our team
For a complete overview of features and configuration options, see Dealer Locator.