Skip to main content

How to customize the map and list view in the Locations plugin

Control how users interact with your map and location list using the Design tab in the Locations plugin.

A
Written by Amr Alshareef
Updated over a week ago

The Locations plugin is one of the most powerful tools in the Buildfire marketplace. This article explains how to customize the layout and user experience using the Design tab.


Requirements

  • This is a Boost plugin, available on the Standard, Growth, and Scale plans.

  • You should first set up your location content—see: How to add and manage locations in the Locations plugin.


How to customize the map and list view

  1. Log in, go to Builder in the left navigation.

  2. Select your Locations plugin from the Features list.

  3. Click the Design tab.

  4. Adjust the List View Position:

    1. Choose whether the list is collapsed, half-expanded, or fully expanded by default.

  5. Choose a Default List View Style:

    1. Select between a compact list with small images or a wide background-style image card.

  6. Select a Map Style:

    1. Default is Light Mode.

    2. You can enable Dark Mode by configuring your Google Maps account.

  7. Choose a Default Map Type:

    1. Streets (default), Satellite, or Terrain.

  8. Configure Quick Filters:

    1. Turn off to hide category filter buttons at the top.

    2. Categories will still be available under the filter icon.

  9. Enable or disable Map Style Selection for users:

    1. This gives users control over how the map is displayed.

  10. Choose how Location Details are shown:

    1. Show or hide category and subcategory.

    2. Display the contributor’s name (if added by a user).

    3. Choose whether the map appears at the top or bottom of each location page.


Pro tips

  • Hiding quick filters can declutter the screen—users can still filter using the icon.

  • If you allow user-contributed locations, showing contributor names adds transparency.


Troubleshooting tips

  • If your custom Google Map styles aren’t displaying, double-check your Google Maps configuration and API key.

  • If images aren’t showing in list view, confirm that each location has a List Image uploaded.

Did this answer your question?