> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loqate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload and Manage Locations for Store Finder

> Upload store locations with coordinates, opening hours, and descriptions through the UI or Create List API.

There are two ways to create a Location List - via the [Create List API](/api-reference/store-finder/location-management-create-list), or via your Loqate account at account.loqate.com. In this guide we'll take you through the process of creating, editing and deleting Location Lists within the account section. These lists can then be used in our [Distance Finder API](/api-reference/store-finder/global-distance-finder) to calculate distances between an end user and your stores (or other locations).

<Tip>A Location List should contain all the information you want to display to customers about your stores, including their names, co-ordinates and their IDs. It can also contain additional information (such as a description of each location, opening times, and address), to provide further context that your end users might find helpful.</Tip>

This guide is split up into the following sections:

* Creating a Location List
* Uploading locations
* Viewing and editing locations
* Deleting a list
* Finding an existing list

## Creating a Location List

To create a new Location list, go to the [Add Service page](https://account.loqate.com/account#/Setup/) in your account section and select **Location List** from the grid of service options.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-1-june-25.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=39824102d9a5588ff3fc330f3244fe03" alt="Location List 1" width="1621" height="787" data-path="images/store-finder/creating-and-managing-location-lists/location-list-1-june-25.png" />

## Naming your list

This will open the Location List setup screen where you can give your list a name and description. We recommend you give your list a clear, easy to remember name and description for easier identification later on.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-2-june-25.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=dbff8981154decc0c6a52b02a7bbf117" alt="Location List 2" width="1452" height="585" data-path="images/store-finder/creating-and-managing-location-lists/location-list-2-june-25.png" />

## Uploading your locations

Once you have given your list a name, the option to upload your list as a CSV file will appear.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-3-june-25.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=2368fa372328219a0bc49c1a29d19c46" alt="Location List 3" width="1104" height="792" data-path="images/store-finder/creating-and-managing-location-lists/location-list-3-june-25.png" />

Any CSV file you upload must contain the mandatory headers of **Name**, **Description**, **Address**, **Latitude** and **Longitude**, while it can also contain additional optional headers related to store opening hours. You can download an example CSV template at the bottom of the page.

If you want to geocode your locations (i.e. you have the addresses but no co-ordinates), you can select the **Geocode Address** toggle and we will append those for you up to a maximum of 500 locations per list.

<Tip>Please note that each address geocoded constitutes one geocoding charge against your account. When using this option please ensure that you have a valid address for each line in your CSV, otherwise the upload will fail.</Tip>

Click on the **Browse** button to select your file, then the **Upload** button to upload and save your locations.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-4-june-25.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=9aae3bf3169c828285d0e29fd528f017" alt="Location List 4" width="1103" height="823" data-path="images/store-finder/creating-and-managing-location-lists/location-list-4-june-25.png" />

You'll see the name of your selected file displayed underneath, along with its upload status.

<Tip>When locations are uploaded they are automatically assigned an ID. This means that if you download a list at a later date you can edit the fields of individual locations and, provided you don't change their IDs, can reupload it to modify an existing list.</Tip>

Once your file is uploaded, you now have a complete Location List with an ID that's ready to use with our Distance Finder endpoint. Please keep a note of the List ID that is automatically generated as this will be the primary identifier used with any of our APIs.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-5-june-25.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=5ac294ce7fbf9e8136e1e3f0fe18dd71" alt="Location List 5" width="823" height="514" data-path="images/store-finder/creating-and-managing-location-lists/location-list-5-june-25.png" />

## Viewing and editing locations

Once a list has been uploaded, you can go to the **Locations** tab to view all of the locations within that list. You can use the search field to filter through these if required, or select **Download list** to export the list back to a CSV file.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-6-june-25.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=8e3b6712154844a8af800f223310a9b4" alt="Location List 6" width="809" height="554" data-path="images/store-finder/creating-and-managing-location-lists/location-list-6-june-25.png" />

From here you can either edit or delete individual locations. To **delete** a location, click the bin icon on the relevant line of the table.

Click the notepad icon next to a location to **edit** it - this will take you to the following screen.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-7-june-25.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=d7eee731fbe50a40f475a46ece8a36a9" alt="Location List 7" width="811" height="815" data-path="images/store-finder/creating-and-managing-location-lists/location-list-7-june-25.png" />

From here you can edit each of the individual fields associated with a location, including opening times.

## Deleting a list

If you decide that you no longer need a Location List, you can remove it in the **Delete** tab.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-8-june-25.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=7f8f1083e3bc8b9b7e0ae8aaaaf7d3d7" alt="Location List 8" width="816" height="326" data-path="images/store-finder/creating-and-managing-location-lists/location-list-8-june-25.png" />

<Warning>Please note that deletion is permanent as we do not keep backups once a list has been marked as deleted.</Warning>

## Finding an existing list

Once you have created a list, you'll need to know where to find it in your Account section if you want to edit or delete it in future.

To do this, start by heading to [**Your Services**](https://account.loqate.com/account#/Dashboard/) in your account section.

From there you will be presented with a list of your installations, API keys and Location Lists. You can filter through these by using the search bar.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-10.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=fb846c7617198370732e0d80b34d0596" alt="Location List 10" width="619" height="233" data-path="images/store-finder/creating-and-managing-location-lists/location-list-10.png" />

Once you have found your list, select it to go to the Configuration screen for that list.

<img src="https://mintcdn.com/loqate/VN7o3YzokUitxNJS/images/store-finder/creating-and-managing-location-lists/location-list-11-june-25.png?fit=max&auto=format&n=VN7o3YzokUitxNJS&q=85&s=20a5e2b94078a595964d8856f77a354a" alt="Location List 11" width="797" height="492" data-path="images/store-finder/creating-and-managing-location-lists/location-list-11-june-25.png" />
