# Setting up your csv file

## How does the csv file work?

Updating your csv file allows you to bulk update all locations onto Maps. **Each row represents one location on the map.** 

{% hint style="info" %}
Please download the sample csv file and make edits directly to that file.
{% endhint %}

<figure><img src="/files/Z2MrGr07Svc0rL521pCx" alt=""><figcaption></figcaption></figure>

## Adding addresses&#x20;

Fill in the address of the location. If the location has a postal code, please include it in the address. Otherwise, you will need to provide the latitude and longitude coordinates instead.&#x20;

Should both postal codes and coordinates be provided, Maps will use the coordinates to plot the location.&#x20;

{% hint style="warning" %}
Without either a postal code or coordinates, the location won’t appear on the map.
{% endhint %}

<figure><img src="/files/3ZC5DWl68bwzFnG28OdH" alt=""><figcaption></figcaption></figure>

| Column               | Description                                                                    | Example                                         |
| -------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------- |
| Name                 | Name of location                                                               | Chocolate Origin                                |
| Address              | Address, including postal code of the location.                                | 4 Changi Village Rd, #01-2094, Singapore 500004 |
| Latitude (Optional)  | An optional latitude value for the location if postal code is not available.   | 1.389273                                        |
| Longitude (Optional) | An optional longitude  value for the location if postal code is not available. | 103.987414                                      |

{% hint style="warning" %}
Please note that Google Sheets or Microsoft Excel might automatically remove leading zeros from postal codes. Before uploading your file to Maps, ensure all postal codes contain the correct six digits, or Maps may not be able to pick up your data.&#x20;
{% endhint %}

## How it looks like on Maps

After setting up your csv file, upload it to Maps and preview your locations mapped out accordingly in draft mode.&#x20;

<figure><img src="/files/MDiwF1DIR5QAeHQ2huw8" alt=""><figcaption></figcaption></figure>

## What else can you add to your map?

Other than addresses and latitude and longitudes coordinates, you may also add notes, links and filters to your map.&#x20;

{% content-ref url="/pages/brZA36THWixludVl3JCU" %}
[Adding notes and links](/creating-your-map/setting-up-your-csv-file/adding-notes-and-links.md)
{% endcontent-ref %}

{% content-ref url="/pages/JLBilMA53Mf3GU48B5a0" %}
[Adding filters](/creating-your-map/setting-up-your-csv-file/adding-filters.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.maps.gov.sg/creating-your-map/setting-up-your-csv-file.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.