# Timeline

A timeline is a list that depicts how a set of resources are used over time. If you're managing a software project and want to illustrate who is doing what and when, or if you're organizing a conference and need to schedule meeting rooms, a timeline is often a reasonable visualization choice.

![](/files/-MEU_wiGnrGm-DxYGHtY)

### Timeline data settings

Once you have added your resource and performed an SQL or API request to your resource, or selected a collection from the list, you need to configure the Timeline display.

For example, you need to display a timeline for upcoming events, simply select the collection from your resource and set a date field.

![](/files/-MEUcNKwvNUZ0PPv_gia)

More information about Display Settings, Search and Action you can find in our documentation.

{% content-ref url="/pages/-MA3jHFbDtb4wavMqoIN" %}
[Lists](/user-guide/design-and-structure/components/lists.md)
{% endcontent-ref %}


---

# 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.jetadmin.io/user-guide/design-and-structure/components/lists/timeline.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.