# Lists

The List is an interface that will present locations to your users as a list on your map. This is perfect for creating a [Store Locator](/maps/lists/store-locator.md).

<figure><img src="/files/it5vMl44DI3B2G7PUA9a" alt=""><figcaption><p>Simple list with geocoder.</p></figcaption></figure>

### Include Geocoder

If you want to include a location search on top of your list, use the Geocoder Control in the "Controls" section, and it will interact naturally with the List.

### Sort by Distance

Sorts by the distance of the current map's center (adjusting as user searches or moves).

### Show Distance

Show distance from the map center to the shape's center. You can also choose the **units**.

### Listing Type

You can make the list eternally scrollable, or have it break into paginated sections. If paginated, you can choose the **number of locations** to show on the list at a single time.

### Render in External Div

If you want the list to render outside the map in a custom div, put the div ID here.

### List Order <sup><sub>*<mark style="color:green;">\[Pro]</mark>*<sub></sup>

Automatically sort the items in your list by menu order, title, slug, or ID. By default, they render by date.

### Display Images <sup><sub>*<mark style="color:green;">\[Pro]</mark>*<sub></sup>

Show thumbnail images above the title in the list.

### Group by Category <sup><sub>*<mark style="color:green;">\[Pro]</mark>*<sub></sup>

You can group items together by their categories into individual accordion lists, further compressing your list.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wpmaps-docs.mapster.me/maps/lists.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
