For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create your first map

A one-page guide to publish your first map.

Step 1: Log in with your gov.sg or approved email address

gov.sg email addresses can log in directly. If your non-gov.sg email address is not yet approved, reach out to us.

Enter your email address to get an OTP, which will be used to log in.


Step 2: Click the Create New Map button

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.


The public will see the map title as a header in the top left of your map. We suggest keeping map titles to under 8 words for better readability. E.g. in our demo map here, 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".

Short 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 shareable map URL of "https://maps.gov.sg/nea-cfhp".

If no short link is provided, Maps generates one for you. The map remains private while it is a draft; the link becomes publicly accessible only after you publish the map. You may update your map titles, descriptions and short links anytime after your map is created.


Step 4: Upload locations in the CSV template provided

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

The columns translate to the following on map markers:

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 are provided in the next columns.

Latitude & Longitude (Optional) - optional latitude & longitude values for the point; we will use these to plot the location on the map instead of the postal code.

Notes (Optional) - shown as text to map users, with links automatically hyperlinked. Learn more about adding notes and links.

Step 4b: Add filters for your points

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).

The column name will be used as the Filter Name (in this example, "Seating Type").

The values provided will be the options that map users can select from (in this example, "Indoor Seating" or "Outdoor Seating"). If points have multiple values for filters, separate the filter values with a comma.

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


Step 5: View a preview of your map

Maps takes a short while to process your locations after upload. If you see Map is still processing..., you can navigate away from the page — an email will be sent to you when the processing is complete. Once processing finishes, a preview of your map will be shown. You may try features 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 publicly accessible.


Step 6: Publish your map

Click on the Publish map icon on the navigation bar on the left.

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.


Step 7: Edit map details

Last updated