Skip to main content

How to add and manage locations in the Locations plugin

Learn how to set up individual or bulk locations, organize them into categories, and configure your plugin’s intro screen.

A
Written by Amr Alshareef
Updated over a week ago

The Locations plugin is one of the most powerful tools in the buildfire marketplace. It allows you to create, display, and organize physical places within your app—complete with categories, filtering, bookmarks, ratings, and more. This article covers how to add and manage location content.

Requirements

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

  • A Google Maps API key is required for location mapping.

How to add and manage locations

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

  2. Click the + button at the top left to open the Plugin Marketplace.

    1. Search for Locations, then click Add Plugin.

    2. Name your plugin and click Add.

  3. Stay in the Content tab.

    1. You can manually create a new location by clicking + Add Location

      1. Enter a Title (required).

      2. Add an optional Subtitle and choose whether to Pin This Location to Top.

      3. Enter the Location Address (required; Google Maps API key must be active).

      4. (Optional) Add a Custom Name to appear under the map pin.

      5. Choose a Pin Type: default pin, circle, or custom image.

      6. (Optional) Assign this location to a Category.

      7. Turn on Opening Hours to show an Open/Closed status.

      8. Turn on Price Range and 5-Star Rating if desired.

      9. Upload a List Image (required).

      10. Upload optional Location Images.

      11. Add a Description (you can also insert media, links, and HTML using the WYSIWYG editor).

      12. Add an optional Action Item to link users to another plugin or external content.

    2. Add locations in bulk (optional):

      1. Click Bulk Upload.

      2. Download the CSV template:

        • Row 1 contains column headers — do not modify.

        • Row 2 contains instructions — do not modify.

        • Add your locations starting in Row 3.

      3. Upload your completed CSV file to import locations.

  4. Click the Categories tab.

    1. Click + Add Category, give it a Name, and (optionally) add an Icon.

    2. You can also create Subcategories under each category.

    3. Categories can also be bulk uploaded or exported.

  5. Click the Introduction tab:

    1. Add an Image Carousel for the top of the screen.

    2. Use the WYSIWYG editor to add welcome text or context.

    3. Show Pinned Locations, All Locations, Nearby Locations, or Local Area options.

    4. Choose a Sort Order: by distance, alphabetically, or by newest.

Pro tips

  • Use categories to help users filter by interest or type (e.g., “Restaurants”, “Stores”, “Parks”).

  • Use the Action Item to link each location to its own plugin or website.

  • For more advanced features leveraging the Locations plugin, see the other articles in this series:

  • Customizing the map and list view.

  • Enabling user interaction and moderation.

  • How users can engage with locations in your app.

Troubleshooting tips

  • If locations don’t appear on the map, double-check that your Google Maps API key is valid and active.

  • Required fields like Title, Address, and List Image must be completed for a location to display properly.

Did this answer your question?