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

# @title

## Quick Reference

```sql
-- @title: Sales by Month
```

## Valid Types

`String`

A string value of how you want to title the chart

## Full Example

```sql
-- @title: Auto Heatmap
-- @subtitle: An example auto generated heatmap comparing two categories
SELECT
Owner,
Channel,
count(*) as Sales
FROM Sales
WHERE Sales.Status = 'Won'
GROUP BY Owner, Channel
```

Chart titles are used in various places thoughout the UI

File menu:

<div align="left"><figure><img src="/files/pFDA8OX0OxZJjXADAaFZ" alt=""><figcaption><p>Example of a chart title showing in the file list</p></figcaption></figure></div>

File List:

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

## Use Cases

Setting a @title gives your chart a more user friendly title. When no title is set, the file name is the default title.