> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/readme/navigating-telmai.md).

# Navigating Telmai

The side menu, header and account menu, and where each part of Telmai lives.

Every page in Telmai shares the same frame: a side menu on the left, a header across the top, and the page content in the middle.

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-e4d656f5782ecb24f92534a0eed531f6aad9af6e%2Fnavigating-telmai-overview-2026-11-04.png?alt=media" alt="The Telmai header and the expanded side menu, with the description of Assets shown on hover"><figcaption><p>The expanded side menu. Hovering over an item shows what it is for.</p></figcaption></figure>

## Side menu

The side menu lists each part of the product. It shows icons only until you hover over it; then it expands to show each item's name, and hovering over an item shows a short description of it. Click the menu icon at the top left of the header to keep the menu open.

| Menu item      | What it is for                                                                                                                                                                 |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Ask AI         | Chat with the AI agent about your data, incidents, monitors and connections. See [Ask AI](https://docs.telm.ai/telmai/ask-ai.md).                                              |
| Home           | Overview of data health across your assets. See [Home](https://docs.telm.ai/telmai/readme/home.md).                                                                            |
| Incidents      | Investigate data issues. The number next to it is the count of open incidents. See [Incidents](https://docs.telm.ai/telmai/monitoring-data/incident-portal.md).                |
| Assets         | Explore and monitor datasets. Profiling, monitors, lineage, scans and settings for each asset live here.                                                                       |
| Reports        | Review and explore scan results across assets: Row checks, Noisy monitors, Stale assets and Dashboards. See [Reports](https://docs.telm.ai/telmai/monitoring-data/reports.md). |
| Connections    | Manage access to your data: connections and, if enabled, the catalog. See [Connect to Data](https://docs.telm.ai/telmai/connect-to-data.md).                                   |
| Administration | Manage users and settings. Visible to tenant admins only. See [Administration](https://docs.telm.ai/telmai/administration.md).                                                 |

{% hint style="info" %}
**Ask AI** only appears when the owners of your Telmai environment have installed it and turned it on for your tenant. See [Ask AI](https://docs.telm.ai/telmai/ask-ai.md).

In a tenant that has no assets yet and has AI turned on, Telmai opens on **Ask AI** so you can add a connection and your first assets from the chat. Home, Incidents and Reports become available once assets exist.
{% endhint %}

Monitors are not a separate menu item: open an asset from **Assets** and use its **Monitors** tab. Rule templates open from the **Rule templates** link on that tab. Ticket templates live in **Administration** > **Jira** or **ServiceNow**.

## Header

* **Search assets and connections** — jump straight to an asset (by name or ID) or a connection: *Jump to an asset (name or ID) or a connection...*. Press `⌘K` (macOS) or `Ctrl+K` (Windows and Linux) to open it.
* **Ask AI** — opens the Ask AI panel beside the current page. Questions you ask there carry the context of what you are looking at, such as the open asset. See [Ask AI](https://docs.telm.ai/telmai/ask-ai.md).
* **Account menu** — your initials, at the top right.
* Click the **Telmai** logo to return to Home.

### Account menu

| Item                | What it does                                                                                                            |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Warnings            | Shows tenant warnings that need an admin's attention. Admins only. The count on your initials shows how many there are. |
| Change password     | Change the password of your Telmai login.                                                                               |
| Switch tenant       | Switch to another tenant you have access to.                                                                            |
| Manage tenant users | Add or edit users of this tenant. Tenant admins only.                                                                   |
| Help center         | Opens the Telmai documentation in a new tab.                                                                            |
| Log out             | Signs you out of Telmai.                                                                                                |

## Getting started checklist

Until a tenant has assets, the **Connections** page shows a **Getting started** strip that tracks the first steps: **Connected**, **Assets added**, **First scan** and **Monitors**. Each step is ticked when it's done, and the strip offers the next action, such as **Add an asset** or **Run a first scan**. Dismiss it with its close button when you no longer need it.

## Filters and sharing

Most pages have a filter bar at the top, for example **Date**, **Project** and **Connection**.

Use **Share** at the end of the filter bar to copy a link to the current view, including its filters and date range. Anyone with access to the tenant who opens the link sees the same view.

## Keyboard

* `Esc` closes the drawer, dialog or panel that opened last.
* Links, tabs, drawers and lists can be reached and opened with the keyboard.
* When a form has unsaved changes, Telmai asks before you leave the page.
