> For the complete documentation index, see [llms.txt](https://help.felt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.felt.com/layers/legend.md).

# Legend

The legend shows viewers what is on your map. Customize its captions, names and colors, and add layer attribution.

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FvrcLi0w217nsFSVDFPXz%2Fimage.png?alt=media&amp;token=f183db5f-f06d-4bbc-b907-968a0cf97afb" alt="" width="320"><figcaption></figcaption></figure>

Felt offers two different views for managing map content:

* **List** view: Shows all layers and annotations in your map. This is your workspace as a map editor, where you make changes and customizations.
* **Legend** view: Shows what viewers will see when looking at your shared or embedded map.

## Customizing your legend

Add a caption, retouch colors and display names in the **Legend** tab.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FNWpHI8A8beG3jB5o5yfb%2FScreen%20Recording%202025-03-03%20at%208.10.28%E2%80%AFPM.mp4?alt=media&token=8088deea-f1c8-4869-8b8b-653157053703>" %}

### Adding captions to layers and groups

Enhance your legend with descriptive captions:

* Select a layer or group in the List view
* Find the **Legend** section in the style editor
* Enter your descriptive text in **Caption**
* The caption will appear below the layer or group name in the legend

## Edit layer metadata

Viewing the underlying data is important, but understanding how it was prepared is just as critical. If you are licensing data from any data providers and need to provide those details in Felt, you can add attribution metadata to data layers in Felt. Adding an attribution to layers in Felt will add attribution information to the credits in the bottom left corner of the Felt map.

From the **···** menu of the detail panel, select **Actions** > **Edit metadata** to add information about a layer's source, attribution or license.

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FKVVH81OniBVwCCWe6Xqn%2Fimage.png?alt=media&amp;token=6b2e80fe-955f-4ec5-8e5d-51c921d69a62" alt="" width="375"><figcaption></figcaption></figure>

The Attribution **Display text** section gets added to the map credits at the bottom left corner of the map.

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FMKuBQcfGOgRkWbQcqemy%2FScreenshot%202025-03-03%20at%208.36.51%E2%80%AFPM.png?alt=media&amp;token=98fcace4-9a1a-47b0-97e4-2878d1e4bb88" alt=""><figcaption></figcaption></figure>

Viewers will be able to access and review the layer metadata via the legend:

{% columns %}
{% column %}

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FKFkEEA9vEyWM80jMHN3o%2Fimage.png?alt=media&amp;token=06c3de3f-d4b6-4120-b1d0-cc217dda3890" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FQAzSqJ4i9LwXi0RLqTM6%2Fimage.png?alt=media&amp;token=b176b7f9-aecc-4f30-bcf4-9a857f9dc755" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## Layer groups

To group layers and choose how viewers toggle them in the legend, see [Layer groups](/layers/organize-layers.md#layer-groups).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.felt.com/layers/legend.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.