> For the complete documentation index, see [llms.txt](https://wpmaps-docs.mapster.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wpmaps-docs.mapster.me/maps/lists.md).

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