onboarding-all-product-locator-options

To start, click on the tool icon from your wizard.

Select product locator.

Style Preset

We suggest horizontal dealers or stacked dealers, so that all messaging is visible.

Primary Color

We suggest coding the colors in your CSS.

This color selection will affect button colors in Dealers Stacked setups and header text and pins in Horizontal Dealers setups (shown below in red).

To add this to an existing product locator, add "color_0": "#000000", to the embed code, where 000000 is the desired hex value.

Secondary Color

This color selection will affect dealer names and "In Stock" callouts in Horizontal Dealers setups (shown below in yellow).

To add this to an existing product locator, add "color_1": "#000000", to the embed code, where 000000 is the desired hex value.

Hover Color

This color selection will affect the hover color for buttons and dealers (shown below in blue).

To add this to an existing product locator, add "hover_color_0": "#000000", to the embed code, where 000000 is the desired hex value.

Hide Button

This checkbox will enable/disable a button that, when clicked, can open a dealer locator window. The button display text is customizable (see Button Text).

To hide the button on an existing product locator, add "always_hide_button": "1", to the embed code.

Button Toggles All Results

When this feature is enabled, the button becomes a dropdown toggle for the dealer results. To enable this feature on an existing Product Locator, add "button_toggles_all": "1", to the embed code.

Button Text

The button display text is customizable in this field. By default, the Dealers Stacked button will display "Find it Locally" and the Horizontal Dealers button will display the Locally heart icon.

To customize this text on an existing Product Locator, add "button_text": "x", to the embed code, where x is the desired text.

Product

Entering a style number into this field will include a "Style:" parameter in the embed code. This will cause the product locator to identify stocking dealers by style number match.

To add this to an existing Product Locator, add "style": "x", to the embed code, where x is the style number.

Entering a UPC or EAN into this field will include a "UPC:" parameter in the embed code. This will cause the product locator to identify stocking dealers by UPC match.

To add this to an existing Product Locator, add "upc": "x", to the embed code, where x is the UPC number.

Show Product Image

Enabling this feature will display an image of the selected variant within the widget. Please note: this feature only works if your Product Locator uses a UPC parameter.

To add this to an existing Product Locator, add "show_product_image": "1", to the embed code.

****Show Brand Name

Enabling this feature will display an the brand name within the widget.

To add this to an existing Product Locator, add "show_brand_name": "1", to the embed code.

Show Product Name Enabling this feature will display an the product name within the widget.

To add this to an existing Product Locator, add "show_product_name": "1", to the embed code.

****

Location

Show Location Switcher

Enabling this feature will add a Location Switcher to the widget, which will allow the user to change their dealer search location within the Product Locator. Shown below, the right side image has the feature enabled and the left side image does not.

To add this to an existing Product Locator, add "show_location_switcher": "1", to the embed code.

Show Location Prompt Text

While the Location Switcher feature is enabled, it can be converted to a prompt text using the Show Location Prompt Text feature. This is shown in the right side image, while the widget in the left side image uses the standard Location Switcher.

To add this to an existing Product Locator, add "show_location_prompt": "1", to the embed code.

The Location Prompt Text is customizable in the PL Options tab of your brand's configuration settings. The custom text below was used to produce the Location Prompt Text above.

Locale

Language

This dropdown menu controls the language translation for applicable words and phrases. Dealer names will not be translated.

To change this on an existing Product Locator, edit the "lang": "en-us", parameter value to the desired language code.

Dealers

Display Dealers

This feature will enable the display of dealers within the widget (first example below). In almost all cases, this feature should be enabled. If it is disabled while the Show Related In-stock Products feature is enabled, the widget will only show related product options (second image below). If neither the Display Dealers or Show Related In-Stock Products features are enabled, the widget will not show any clickable options (third image below).

To change this on an existing Product Locator, add or edit the "show_dealers": "1", parameter in the embed code.

Maximum Dealers Dropdown

The option selected in this menu will determine the maximum number of dealers shown in the widget. If there are less authorized dealers in the searchable area than is selected, only that number of dealers will show.

To adjust this value on an existing Product Locator, edit the "n_dealers": "3", parameter in the embed code from 3 to the desired number.

Only Show Dealers in this Category

If your brand does not use dealer list categories, do not use this feature. If your brand does use dealer list categories, this feature will filter dealer results by the category entered. For example, if a PDP should only show dealers tagged with "platinumdealer", entering the category tag in this field will filter all results that may populate the PL.

To add this to an existing Product Locator, add "category": "tag", to the embed code, where "tag" is the category tag to be used.

You can filter dealer results to multiple categories by separating them with " OR ". For example: "category": "tag1 OR tag2", will show dealers tagged with "tag1" and dealers tagged with "tag2".

Show Unauthorized Dealers

This feature will allow the widget to display additional dealers that have yet to be authorized.

To enable this feature on an existing Product Locator, add "show_unauthed_dealers": "1", to the embed code.

Only Show Style-Stocking Dealers

Enabling this feature will filter the dealer results by only showing dealers that stock products in the same style group.

Please note: using this parameter can cause customer confusion, as the widget may display dealers that aren't reporting stock in a variant the user is viewing, but are reporting stock in a different variant in the same style group.

To enable this feature on an existing Product Locator, add "show_only_stocking_dealers": "1", to the embed code.

Only Show UPC-Stocking Dealers

Enabling this feature will filter the dealer results by only showing dealers that stock products with the same UPC number.

To enable this feature on an existing Product Locator, add "show_only_upc_stocking_dealers": "1", to the embed code.

By default, this will apply to both the widget and the modal. If you'd prefer that the modal display all dealers, you can add the parameter "show_all_dealers_in_modal": "1",

Display Dealer Count

NOTE: This feature only functions on the Dealer Dropdown layout.

This feature will show the number of dealers available to select in the widget. Please note that the number displayed will be limited by the maximum dealers allowed to display in the widget (e.g. if Maximum Dealers is set to 5, the Display Dealer Count metric will be up to 5).

To enable this feature on an existing Product Locator, add "show_dealer_count": "1", to the embed code.