# Location finder Source: https://support.storeconnect.com/articles/location-finder · Last modified 21 August 2026 Set up a location finder so customers can search for the physical places that sell or service your products, such as outlets, stockists, or service centers. You can have several location finders on one site, for example one for outlets and one for service centers. ## Choose how customers will search Decide this before you start, because it determines whether you need a Google Maps API key. | Search style | What the customer does | What it needs | |---|---|---| | Basic search | Selects a country and/or state and sees matching results | Nothing beyond the location records themselves. Results are a straight filter on address data. | | Map results | Sees results plotted on a map | A valid Google Maps API key in the `google_maps_api_key` store variable | | Proximity search | Finds the locations closest to them | The same API key, with the Geocoding service permitted on your Google Maps account | ## The three objects behind a location finder Setting up a location finder uses three objects: 1. **Account** — defines the location and its details. 2. **Location Group** — defines the location finder itself, for example Outlets or Service Centers. 3. **Location Group Account** — a join object found under the **Accounts** related list. It associates **Location Groups** and **Accounts**, so one location can belong to many location groups. ## Set up a location finder 1. Go to the **Location Groups** list and click **New**. 2. Give the group a **Name**, set its **Path** (the finder appears at `/find/{path}`), and relate it to the **Store** it should appear on. 3. Select **Active**. Only active location groups show on the website. 4. Save the record. 5. Open an **Account** you want to list as a location and select the **Is Location** checkbox. 6. Set the **Location Address Source** to `Billing Address` or `Shipping Address`, or leave it empty and fill in the **Location Address** fields yourself. See [location address fields](#location-address-fields) for the full list. 7. Save the **Account**. 8. On the **Account**, go to the **Location Groups** related list and add the location group you created. This creates the **Location Group Account** join record. 9. Repeat steps 5 to 8 for each location. 10. Visit `/find/{path}` on your store and confirm your locations appear and can be searched. An **Account** only appears as a location when both of these are true: **Is Location** is selected, and the account belongs to a **Location Group**. :::note If you use the billing or shipping address as the source, the location address fields are populated with a copy of the source address whenever the record is created or updated. Editing the source address updates the copy on the next save. ::: ## Account location details - **Is Location** — determines whether an **Account** is being used as a location. It affects nothing else, but the account is only treated as a location when this is selected. - **Location Address Source** — a picklist. Leave it empty, or set it to `Billing Address` or `Shipping Address` to prefill the address fields below. ![Location Details section on an Account record, showing the Is Location checkbox and the Location Address Source picklist](https://res.cloudinary.com/hzkr6fi81/image/upload/v1781677654/documentation-media/locationdetails1.png) - **Is Location** — determines whether an **Account** is being used as a location. It affects nothing else, but the account is only treated as a location when this is selected. - **Location Address Source** — a picklist. Leave it empty, or set it to `Billing Address` or `Shipping Address` to prefill the address fields below. ![Location Details section on an Account record, showing the Is Location checkbox and the Location Address Source picklist](https://res.cloudinary.com/hzkr6fi81/image/upload/v1781677654/documentation-media/locationdetails1.png) ### Location address fields Used when **Location Address Source** is empty. | Field | Description | |---|---| | Location City | Address City | | Location Country | Address Country | | Location Postal Code | Address Postal Code | | Location State | Address State | | Location Street | Address Street | | Location | Geolocation field for latitude and longitude | | Location Path | The URL path the location is available at on the website (depending on theme). It must be unique per store. | | Location Display Name | The location name that shows on the website (depending on theme). If not provided, the Account's Name field is used. | | Location Email | The location's email address to show on the website (depending on theme). | | Location Phone | The location's phone number to show on the website (depending on theme). | | Location Website | The location's web address to show on the website (depending on theme). | | Location Info Markdown | Content to show on the website (depending on theme). | | Location_Meta_Description | For SEO Search Description | | Location_Meta_Keywords | For SEO Keywords | | Location_Meta_Title | For SEO Title | When you supply the location address fields manually, you must also supply latitude and longitude values in the **Location** geolocation field. Without them, the location cannot appear on the map or be found by a proximity search. ## Location Group fields | Field | Description | |---|---| | Active | Only active location groups show on the website. | | Display Name | The name of the location finder on the website. If not provided, the Name field is used. | | Meta Description | Content for the meta tags (used for SEO) | | Meta Keywords | Content for the meta tags (used for SEO) | | Meta Title | Content for the meta tags (used for SEO) | | Path | The URL path the location finder is available at on the website. It must be unique per store. Your location finder is found at `/find/{path}`. | | Store | A location group must be associated with a **Store**. It only shows on the website for the store it is associated with. | ## Location filters The simplest implementation of **Location Finder** searches on location alone. There are two ways to refine the search further. ### Category filters For a **Product Category** to be relevant to a **Location Group**, it must share the same **Store** via taxonomy as the location group. The product category can belong to any of the store's taxonomies. ![Product Categories related list on a Location Group record](https://res.cloudinary.com/hzkr6fi81/image/upload/v1781677655/documentation-media/locationproductcategory1.png) ![Location Product Category record linking a product category to a location group](https://res.cloudinary.com/hzkr6fi81/image/upload/v1781677656/documentation-media/locationproductcategory2.png) The product categories do not need to contain any products. They are purely a way to tag locations for search purposes. ### Product filters Product filters build on category filters. Set up your category filters first, then add **Products** to those categories. The search can then return location results for a specific product. You can add a link or button on the product page that opens that product on the location finder page. For example, the finder might be called Stores and the button labeled Where to Buy. ## Google Maps integration **Location Finder** reads one [store variable](store-variables), `google_maps_api_key`. When it is set to a valid Google Maps API key, the map appears on the location finder (depending on theme). Permitting your Google Maps account to use the Geocoding service also enables proximity searching, so customers can find locations near them. If Salesforce address fields are not populating geolocation data, check that the corresponding **Data Integration Rules** for geocoding are active and that the address data is complete and accurate. Salesforce publishes [an article on this common org question](https://help.salesforce.com/s/articleView?id=000692560&type=1). ## URL parameters You can control parts of **Location Finder** by passing URL parameters. The parameters are visible in the address bar as you use the location finder, and you can use them to send a customer straight to a page with a particular location or account already shown. --- ## Follow StoreConnect - [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter) - [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464) - [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g) - [LinkedIn](https://www.linkedin.com/company/storeconnect) - [X / Twitter](https://x.com/storeconnecthq) ## Popular Links - [Partners](https://getstoreconnect.com/partners) - [News](https://getstoreconnect.com/articles/news) - [Events](https://getstoreconnect.com/articles/events) - [Feature Comparison](https://getstoreconnect.com/how-we-compare) - [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT) - [Book a Demo](https://getstoreconnect.com/contact) ## Documentation - [Help documentation](https://support.storeconnect.com/help-documentation) - [AI agents](https://support.storeconnect.com/ai) - [Videos & tutorials](https://support.storeconnect.com/videos-tutorials) - [Developer reference](https://support.storeconnect.com/developer-reference) - [Release notes](https://support.storeconnect.com/release-notes) - [Troubleshooting](https://support.storeconnect.com/troubleshooting) - [Trust Center](https://trust.getstoreconnect.com/) - [Status Page](https://status.storeconnect.com/) ## Contact - info@getstoreconnect.com - US +1 415 745 3230 - AUS +61 2 8365 2308 100 S Ashley Dr, Suite 600-2461 Tampa FL 33602-600 USA Level 22, Sydney Place 180 George Street Sydney, NSW, 2000, AUS --- StoreConnect Support — https://support.storeconnect.com/articles/location-finder