> 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
Primary name for your chart that is displayed throughout the UI
## 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:
Example of a chart title showing in the file list
File List:
## 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.
