# @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="https://4045370218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0xzzR5x0BnQ6kHixlzd%2Fuploads%2FmJN9ZVpb48kG3lnMBiU7%2Fimage.png?alt=media&#x26;token=2d4d2a88-52b2-469f-a3da-655b90468bec" alt=""><figcaption><p>Example of a subtitle in the file list</p></figcaption></figure></div>