> 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/creating-your-map/getting-started.md).

# Getting started

**Step 1:** Click **Create New Map** to start creating your map.

If no maps have been previously created, this page will appear empty.

<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 2:** Enter a **map title, description** and **short link**.

**Map title**: This is what citizens will see in the top left of your map. Short titles are easier to read. Try keeping it under 8 words.

**Description:** Write a summary to let citizens know what they can find on this map. We recommend keeping it concise to under 15 words.

**Short link:** By default, a randomly generated link will be used if you do not include a short link. Adding a short link would make it easier for citizens to navigate to your map (e.g. maps.gov.sg/**your-map**). Use dashes in between words for better readability.

{% hint style="info" %}
You may update your map title, description and link anytime after your map is created. See [Updating map details](https://guide.maps.gov.sg/making-updates-to-your-map/updating-map-details.md) and [Change your map link](https://guide.maps.gov.sg/sharing-your-map/sharing-your-unique-map-link.md#change-your-map-link).
{% 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 3:** Click on **Next**.

**Step 4:** Click on the **Download CSV Template** provided and fill in your locations accordingly.

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

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-78685d283fe2908b419c7426cc7918c648a7e391%2FScreenshot%202025-08-14%20at%201.49.09%E2%80%AFPM.png?alt=media" alt=""><figcaption></figcaption></figure>

For more details on how to fill up your CSV file to include advanced features (e.g. filters), refer to the section on [Setting up your CSV file](https://guide.maps.gov.sg/creating-your-map/setting-up-your-csv-file.md).

**Step 5:** Upload the CSV file and click **Create 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>

{% hint style="info" %}
Maps takes a short while to process your locations. 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.
{% endhint %}

**Step 6:** Congrats! Your map has now been created and is in the draft stage. You may now preview your map.

The map is currently not publicly accessible. Test features such as search and filtering to ensure that they are working as intended before you publish the map.

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-16fb24d62cca958d04f1543756b822966a87d5be%2FScreenshot%202025-08-19%20at%205.11.04%E2%80%AFPM.png?alt=media" alt=""><figcaption></figcaption></figure>

**Step 7:** To make your map available at its link, select the **Publish map** icon on the navigation bar on the left.

**Step 8:** Under **Map state**, select **Live**, then select **Make map live** to confirm. Under **Share this map**, you can now copy the map link, download the **QR code** and, for a public map, copy the **Embed code**.

You may switch the map back to **Draft** anytime to unpublish it.

{% hint style="warning" %}
New maps are **private**, so publishing alone does not make your map publicly accessible. Under **Access type** on the same page, choose **Public map** if you want anyone with the link to view it. See [Making a map private](https://guide.maps.gov.sg/sharing-your-map/making-a-map-private.md).
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-4ac5364ccae600b13457194042a348686f02ea63%2Fpublish-map-state-live.png?alt=media" alt="Map state card with Live selected, and the Share this map section with the map link, embed code and QR code"><figcaption></figcaption></figure>

#### Congratulations, you have just published your first map on maps.gov.sg!
