> 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/making-updates-to-your-map/applying-colours-to-markers.md).

# Applying colours to markers

Apply colours to your markers so map users can tell locations apart at a glance.

## How it works

Choose a filter, such as "Seating Type". Then choose a colour for each of its values, such as blue for "Indoor seating" and green for "Outdoor seating". You can colour more than one filter, and map users can switch between them.

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-f6a1e26274b5144b30571aa6a8367c357caf1fd8%2Fcolours-map-coloured-markers.png?alt=media" alt="Map with markers coloured by Type of centre, and matching coloured labels in the location list"><figcaption></figcaption></figure>

Your map must have filters before you can apply colours. If it doesn't have any yet, [add filters to your CSV file](https://guide.maps.gov.sg/creating-your-map/setting-up-your-csv-file/adding-filters.md) first.

**Owners** and **Editors** can apply colours, in the desktop Maps editor.

## Before you start: Check that your filter can be coloured

A **filter** groups your locations, such as "Seating Type". Its **filter values** are the options inside it, such as "Indoor seating" and "Outdoor seating".

Not every filter can have colours. A marker shows only one colour at a time, so each location must have exactly one value in the filter. If a location has two values, Maps can't choose which colour to show. If it has none, there is no colour to show.

You can colour both filters here, because every location has one value in each:

| Name   | Seating Type    | Cuisine  |
| ------ | --------------- | -------- |
| Cafe A | Indoor seating  | Chinese  |
| Cafe B | Outdoor seating | Western  |
| Cafe C | Indoor seating  | Japanese |

You can't colour either of these filters. In Seating Type, Cafe B has two values and Cafe C has none. In Cuisine, Cafe A has two values:

| Name   | Seating Type                    | Cuisine          |
| ------ | ------------------------------- | ---------------- |
| Cafe A | Indoor seating                  | Chinese, Western |
| Cafe B | Indoor seating, Outdoor seating | Western          |
| Cafe C |                                 | Japanese         |

If you want to apply colour to a filter that is blocked, [update your CSV file](https://guide.maps.gov.sg/creating-your-map/setting-up-your-csv-file/adding-filters.md) so each location has one value in that column, then [replace your locations](https://guide.maps.gov.sg/making-updates-to-your-map/updating-locations.md).

## Apply colours to a filter

**Step 1:** On your map's edit page, click **Style markers** at the bottom right of the map

**Step 2:** Choose the filter you want to colour

**Step 3:** Select a value, then select a colour. Repeat for each value you want to colour. Two values can share a colour

**Step 4:** If you colour more than one filter, select **Show these colours by default to map viewers** to make this filter the first one map users see

**Step 5:** Click **Apply**

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-f5fb74647121f76d45c0093dc1021619137c5b5b%2Fcolours-marker-colours-panel.png?alt=media" alt="Marker colours panel on the map edit page, with the Select a filter dropdown, a list of filter values with marker counts, and the Style markers button at the bottom right"><figcaption></figcaption></figure>

Values you don't colour use the default marker colour. To remove a colour, select it again and click **Apply**. To clear every colour in the filter, click **Reset**. Click **Apply** to save either change.

## Apply colours to more than one filter

Each filter can have its own colours. This means you can give "Seating Type" values one set of colours and "Cuisine" values another.

When you colour more than one filter, map users see your default filter first. They can switch to your other coloured filters from a dropdown on the map.

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-e5071dac75fd2dc3a9ea26df4f89d7be51e9de8b%2Fcolours-map-filter-dropdown.png?alt=media" alt="Map with coloured markers and a dropdown at the top left listing the coloured filters, Repair works and Type of centre"><figcaption></figcaption></figure>

## Update your locations after applying colours

When you [replace your locations](https://guide.maps.gov.sg/making-updates-to-your-map/updating-locations.md), colours remain on values that are still in your new CSV file. Maps removes the colours from filter values that are no longer in the file.
