> 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/subtitle.md).

# @subtitle

## Quick Reference

```sql
-- @subtitle: Sales over time grouped by month
```

## Valid Types

`String`

A short sentence string that describes 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
```

## Use Cases

Use a subtitle when the title is insufficient to convery the purpose of the chart, and you want to add a short description. Subtitles are used in various places in the ChartSQL UI

<div align="left"><figure><img src="/files/vFvwS6wdDyDgm0ho0guR" alt=""><figcaption><p>Example of a subtitle in the file list</p></figcaption></figure></div>