# Create your first map

{% hint style="success" %}
❤️ **Thanks for being an early adopter of Maps!**

Please reach out to us at <team@maps.gov.sg> for any questions.
{% endhint %}

### Step 1: Login with your government/organisational email

{% hint style="info" %}
[**Reach out to us**](https://go.gov.sg/maps-onboarding) **if you have not been granted access to Maps.**

Enter your email address to get an OTP which will be used to login.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2FVZGxU12eIvBfwOiC7cKP%2FScreenshot%202025-04-18%20at%202.18.38%E2%80%AFPM.png?alt=media&#x26;token=36301425-2d1b-42bc-80fb-3ab3bd6b04d7" alt=""><figcaption></figcaption></figure>

***

### Step 2: Click the Create new map button

{% hint style="info" %}
**If no maps have been previously created, this page will appear empty.** Upon following all the steps in this guide, your newly created map will appear on this page.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2FeF54PGyQm6CYzzsvMtJv%2FScreenshot%202025-04-18%20at%202.20.28%E2%80%AFPM.png?alt=media&#x26;token=60a5d308-4621-45e5-ae28-5f8dfe5f4e03" alt=""><figcaption></figcaption></figure>

***

### Step 3: Enter a map title, description and short link

{% hint style="info" %}
The public will see map titles as a header in the top left of your map. We suggest keeping map titles to under 4 words for better readability. *E.g. in our demo map* [*here*](https://maps.gov.sg/muis-mosques)*, the map title is "Mosque Finder".*

\
The public will see map descriptions below the map title. We suggest keeping map descriptions concise to under 15 words and to be verbose in what citizens would find on this map. *E.g. "Find nearby civil defence shelters at HDBs, Schools, MRT stations and more".*

\
*S*hort links make it easier for citizens to navigate to your map. We suggest using a short link with dashes between words for better readability. *E.g. the short link of "nea-cfhp" will result in the sharable map URL of "<https://maps.gov.sg/nea-cfhp>".*

If no short link is provided, a random 24 character string will be used. This randomly generated short link is still publicly accessible (a similar concept to RedeemSG voucher links which although private, are still publicly accessible over the Internet for sharing purposes).\
\
**You may update your map titles, descriptions and short links anytime after your map is created.**
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2FDz9T05wswCYD0QvODIPp%2FScreenshot%202025-04-18%20at%202.43.26%E2%80%AFPM%20copy.png?alt=media&#x26;token=7ca1f3ab-e104-4de4-904f-08658f261984" alt=""><figcaption></figcaption></figure>

***

### Step 4: Upload locations in the CSV template provided

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2F0kfnPdzBfyBjfbJQYv2r%2FScreenshot%202025-04-21%20at%2010.10.31%E2%80%AFAM.png?alt=media&#x26;token=5d6c7925-ccbb-4a0a-9518-bbba6ba74113" alt=""><figcaption></figcaption></figure>

#### Step 4a: Fill in the CSV template with points you want to appear on the map

{% hint style="info" %}
The columns translate to the following on map markers:<br>

Name - shown as the name for the location

Address - shown as the address for the location. **You will need to include the postal code if no latitude and longitude is provided in the next column.**

Latitude & Longitude (Optional) - an optional latitude & longitude value for the point, we will use this to plot the location on the map instead of postal code.
{% endhint %}

{% hint style="warning" %}
We have just released a new feature where you will be able to add Notes to points on a map.\
\
Notes (Optional) - shown as text to map users with links automatically hyperlinked.\
\
Our guides will be updated to reflect this soon.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2FrVXsIRjSHE5CYHYfVl9Y%2FScreenshot%202025-04-18%20at%203.12.55%E2%80%AFPM.png?alt=media&#x26;token=51bf1cb0-fba1-4d45-ade9-e1bb321724ad" alt=""><figcaption></figcaption></figure>

#### Step 4b: Add filters for your points

{% hint style="info" %}
You may optionally add filters for your map markers. To do so, add an additional column on the right. *An example map with filters can be seen here (*[*https://maps.gov.sg/nparks-gardens*](https://maps.gov.sg/nparks-gardens)*).*

\
The column name will be used as the Filter Name (in this e.g. "Seating Type")

The values provided will be the options that map users can select from (in this e.g. "Indoor Seating" or "Outdoor Seating").\
\
**If points have multiple values for filters, separate the filter values with a comma.**
{% endhint %}

{% hint style="warning" %}
We have just realised Notes for map markers, please ensure that your filters are placed in the column after the Notes column in the CSV file.\
\
Our guides will be updated to reflect this soon.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2FpHi66g7trQagSoZhcex1%2FScreenshot%202025-04-21%20at%2010.31.00%E2%80%AFAM.png?alt=media&#x26;token=50971ebb-533a-4e52-bcde-b0dbe30ae3ce" alt=""><figcaption></figcaption></figure>

#### Step 4c: Upload this CSV file to create your map

{% hint style="info" %}
If you encounter any errors, this may be due to an additional blank line at the end of your CSV file. Please remove this line and retry the upload.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2FXGydMTowW5sWrfuo68Zp%2FScreenshot%202025-04-21%20at%2010.27.01%E2%80%AFAM.png?alt=media&#x26;token=ccdad13a-4e10-4418-915b-4045bde13a35" alt=""><figcaption></figcaption></figure>

***

### Step 5: View a preview of your map

{% hint style="info" %}
A preview of your map will be shown after your map is created. You may do things like Search and Filters to ensure that they are working as intended before publishing your map.\
\
Your newly created map is still in the Draft stage and not yet publically accessible.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2FMh2OzL4NNEy8OGA8Y9oX%2FScreenshot%202025-04-21%20at%2010.36.30%E2%80%AFAM.png?alt=media&#x26;token=4ca26c4d-d9ea-4972-a5f4-2e9a3c233131" alt=""><figcaption></figcaption></figure>

***

### Step 6: Publish your map

{% hint style="info" %}
Click on the Publish Map tab to publish your map.

\
Once the toggle to publish the map is enabled, you will be able to easily copy the link to be shared with citizens.\
\
A code snippet is also provided for the map to be embedded into your website.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2FLs5H92ja98irCVKwKEsi%2FScreenshot%202025-04-21%20at%2010.42.17%E2%80%AFAM.png?alt=media&#x26;token=1d05c7d5-dd3b-4c6a-9223-7d7ac8a5002d" alt=""><figcaption></figcaption></figure>

***

### Step 7: Edit map details

{% hint style="success" %}
Click on the Settings tab should you want to update map details such as title, description or short link.\
\
You may also delete your map from this page.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2FJyNiepmSknWXiCScqW1Z%2FScreenshot%202025-04-21%20at%2010.48.18%E2%80%AFAM.png?alt=media&#x26;token=5cf4e2a1-40e0-4ab8-8932-69d7c79d5986" alt=""><figcaption></figcaption></figure>