The eight Builder types and when to use each one
Select Store Locator → Builder → New to see all available types. They fall into three editor modes: content designs, forms, and full locator composition.
| Builder type | What it produces | Used by | Embedded directly? |
|---|---|---|---|
| Store Card | One store's reusable card/content design | Store List widget, selected-store detail, store detail page | No |
| Category tile | One category's reusable tile | Category filter in Tiles mode; Store List Categories → stores mode | No |
| Map infobox | Popup content opened from a map marker | Map widget → Marker popup | No |
| Map marker | Dynamic HTML card anchored at a coordinate | Map widget in HTML card marker mode | No |
| Layout | Complete locator made of widgets | Gutenberg, shortcode, Elementor, WPBakery | Yes |
| Search form | Search controls mapped to locator query parameters | Search widget, Map search overlay, Store List filter drawer | No |
| Store registration | Public form mapped to Store fields | Registration block, shortcode, Elementor | Yes, through its form embed/default |
| Leads form | Public enquiry form stored as a Lead | Lead block, shortcode, Elementor | Yes, through its form embed/default |
Content-design types
Store Card, Category tile, Map infobox, and Map marker use the layout/content editor. Their canvas contains rows, columns, and content elements. Store Card, infobox, and marker designs receive store data. Category tiles receive category data such as category name, icon, color, and store count.
Form types
Search form, Store registration, and Leads form use the form editor, but their fields do different work:
- Search fields modify the live locator query and do not create a submission.
- Registration fields map to new Store fields and custom fields.
- Lead fields create an enquiry record; they are not Store filters.
Search-only field types—Search button, Use my location, Open now toggle, and Sort by dropdown—are not offered in lead or registration forms. reCAPTCHA and Hidden fields are not offered in Search forms because Search forms are not submitted as stored entries.
Layout type
Layout uses the widget editor. Instead of inserting Store fields, its cells contain one of seven locator widgets: Search, Distance filter, Category filter, Brand filter, Result count, Map, or Store List.
The Layout is the root design customers embed. It references the other design IDs selected in its widgets. Read How a complete locator is composed before building one.