> 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/setting-up-your-csv-file/adding-filters.md).

# Adding filters

Filters allow users to **narrow their search according to their specific requirements**. Simply add an additional column on the right of your CSV file, after the 'Notes' column. Filters are **optional**.

## Filters and filter values

A **filter** is a way to group your locations, such as "Seating Type". Each filter has **filter values**, which are the options inside it, such as "Indoor seating" and "Outdoor seating". Map users pick one or more filter values to see only the locations that match.

* **Filter** = a column in your CSV file. The column name is the filter name.
* **Filter value** = what you enter in that column for each location.

In this example, "Seating Type" is the filter. It has three filter values: "Indoor seating", "Outdoor seating" and "No seating".

| Name    | Seating Type                    |
| ------- | ------------------------------- |
| Cafe A  | Indoor seating                  |
| Cafe B  | Outdoor seating                 |
| Cafe C  | Indoor seating, Outdoor seating |
| Kiosk D | No seating                      |

Each row is one location, and each location can have one filter value or several. Cafe C has two values, separated by a comma, so it appears when a map user picks either "Indoor seating" or "Outdoor seating".

{% hint style="info" %}
You can add multiple filters by adding more columns. 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 and shows the error `Maximum of 10 filter columns allowed`.
{% endhint %}

## Set up your CSV file as follows

{% hint style="info" %}
Do note that the name of your column (in the example below, "Seating Type") will determine the name of your filter.
{% endhint %}

<figure><img src="https://585017024-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLmzev03OtnqV1VC7eYj%2Fuploads%2Fgit-blob-e87c14d0159c4cb76d73489cdcc11c30c41adf26%2FFrame%201.png?alt=media" alt=""><figcaption></figcaption></figure>

| Column name (Filter name) | Description                                                                                                                                                                                                                           | Example                                     |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| Seating Type              | <p>The column name will be the Filter Name.<br><br>Enter the filter values for each location in the corresponding fields in this column.<br><br>For points with multiple values under a single filter, separate them with commas.</p> | Indoor Seating, Outdoor seating, No seating |

## What it looks like on Maps

After setting up your CSV file, upload it to Maps and preview your locations mapped out accordingly in draft mode.

Filters will appear right below the search bar.

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

Users can click on each filter and interact with the dropdown menu to choose filter values and search for specific locations within their requirements.

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

## Colour your markers by filter value

Once your map has a filter, you can give each filter value its own marker colour. See [Applying colours to markers](https://guide.maps.gov.sg/making-updates-to-your-map/applying-colours-to-markers.md).
