> For the complete documentation index, see [llms.txt](https://guide.maps.gov.sg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.maps.gov.sg/quick-start/create-your-first-map.md).

# Create your first map

A one-page guide to publish your first map.

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

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

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

{% hint style="info" %}
gov.sg email addresses can log in directly. If your non-gov.sg email address is not yet approved, [**reach out to us**](https://go.gov.sg/maps-onboarding).

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

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-ceacdeb1fc1083bfb34118cb75c09f036ad66555%2FScreenshot%202025-04-18%20at%202.18.38%E2%80%AFPM.png?alt=media" 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%2Fgit-blob-afdabe780bd9f7d4845445e99bfb2689fcd244d6%2FScreenshot%202025-04-18%20at%202.20.28%E2%80%AFPM.png?alt=media" alt=""><figcaption></figcaption></figure>

***

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

{% hint style="info" %}
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*](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".*

\
*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.**
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-e3967e4c7fd863cee6dd73ab0f814ebcca59726d%2FScreenshot%202025-04-18%20at%202.43.26%E2%80%AFPM.png?alt=media" 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%2Fgit-blob-d961a03632b76523f82139c749c66c5812cf045c%2FScreenshot%202025-04-21%20at%2010.10.31%E2%80%AFAM.png?alt=media" 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 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](/creating-your-map/setting-up-your-csv-file/adding-notes-and-links.md).
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-d3c4d7c8e40151d629aae355f3915e41ac9594eb%2FScreenshot%202025-04-18%20at%203.12.55%E2%80%AFPM.png?alt=media" 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 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.**
{% endhint %}

{% hint style="warning" %}
Place filter columns after the Notes column in the CSV file. Each location can have values in up to 10 filter columns. If any row contains values in more than 10 filter columns, Maps rejects the CSV file. Learn more about [adding filters](/creating-your-map/setting-up-your-csv-file/adding-filters.md).
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-fe8d5fa8b09e1b3824b638fb827d1ed9625d0e80%2FScreenshot%202025-04-21%20at%2010.31.00%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-d5b82b907359d53ed417ef509ad89fc9d665f88b%2FScreenshot%202025-04-21%20at%2010.27.01%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure>

***

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

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-62c6ad4fe5f93433b3ee46f95831c34a4474ac03%2FScreenshot%202025-04-21%20at%2010.36.30%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure>

***

### Step 6: Publish your map

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-61fc0f96e0421798a2ff934f4e082518955190a8%2FScreenshot%202025-04-21%20at%2010.42.17%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure>

***

### Step 7: Edit map details

{% hint style="success" %}
Click on the **Settings** icon on the navigation bar on the left if you want to update map details such as title, description or short link.\
\
If you are the map's **Owner**, you can also delete the 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%2Fgit-blob-4c93a1b6defcdce30574e782342b2ca2c7c1ef94%2FScreenshot%202025-04-21%20at%2010.48.18%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure>