# Table widget

The Table Widget offers a clear, structured view of your dataset, enabling easy data exploration. You can **search**, **highlight** features by hovering, and **zoom** to specific features by clicking, all while seamlessly connecting the table to the map.

<figure><img src="/files/1bcMClPcYNlpowt9kUr2" alt=""><figcaption></figcaption></figure>

### Widget Data

In the Data section, you can specify which properties to display in the Table view, allowing you to set labels and customizing the format as needed.

<figure><img src="/files/se111S9sgEEghl7VEUKJ" alt=""><figcaption></figcaption></figure>

### Widget Display

The Display section allows you to add notes that support [Markdown syntax](https://www.markdownguide.org/basic-syntax/) for better clarity and customization. Within the widget, you can choose the number of rows displayed per page and use pagination to view additional data. Sorting can be applied to the columns in either ascending or descending order.

You can also configure whether the widget is **collapsible** and if it should be automatically hidden when the linked layer is not visible on the map.

### Widget behavior

n the Behavior section, you can choose between two modes:

* **Viewport Mode**: Shows only features visible in the current map view. Both displayed data and search are limited to features within the viewport.
* **Global Mode**: Displays all features from the data source, allowing you to search and zoom to any feature, even if it’s outside the current map view.

{% hint style="info" %}
If a **mask** is applied using the Selection tool, this will override both the Global and Viewport modes. In this case, both the displayed data and search results will be limited to the features within the mask's extent.
{% endhint %}

Learn more about widget behavior [here](/carto-user-manual/maps/widgets.md#widget-behaviour).


---

# 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://docs.carto.com/carto-user-manual/maps/widgets/table-widget.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.