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

# @formats

## Quick Reference

```sql
-- @formats: integer, currency 
```

## Valid Values

`List`

@formats must be a comma separated list of formats that map to the columns used within the @series or @secondary-series

* none
* integer
* currency
* percent

## Full Example

```sql
-- @chart: bar
-- @title: Bar Chart With Formats
-- @subtitle: An example bar chart with formats
-- @formats: currency
SELECT 
Channel,
sum(Amount) as Total_Sales
FROM Sales
WHERE Status = 'Won'
GROUP BY Channel
ORDER BY Total_Sales DESC;
```

<figure><img src="/files/jAroCTyrwHnEYAM3HJku" alt=""><figcaption><p>An example bar chart with currency formatting applied to the series</p></figcaption></figure>

## Use Cases

Formats allows you to visually improve the look of number data in your charts to be more clear and visually appealing.

## Example Charts

<table data-card-size="large" data-view="cards"><thead><tr><th data-card-target data-type="content-ref"></th><th data-hidden></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><a href="/pages/41ZFw9Jp5ut2mspSKZHa">/pages/41ZFw9Jp5ut2mspSKZHa</a></td><td></td><td></td><td></td><td><a href="/files/jAroCTyrwHnEYAM3HJku">/files/jAroCTyrwHnEYAM3HJku</a></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>
