# @series-labels
## Quick Reference
```sql
-- @series-labels: inside, top
```
## Type
`List`
Comma separated list of label positions that ordinally match the @series and @secondary-series
## Full Example
```sql
-- @chart: column
-- @title: Series Labels - Label at Top of Series
-- @subtitle: An example column chart with a series label above the top
-- @formats: currency
-- @series-labels: top
SELECT
TRUNC(date_closed, 'MONTH') as Month,
sum(amount) as Sales
FROM sales
-- Select just 1 year so that the labels are not too cluttered
WHERE year(date_closed) = 2017
GROUP BY TRUNC(date_closed, 'MONTH')
ORDER BY TRUNC(date_closed, 'MONTH') ASC;
```
## Valid Values
* true
* false
* top
* left
* right
* bottom
* inside
* insideLeft
* insideRight
* insideTop
* insideBottom
* insideTopLeft
* insideBottomLeft
* insideTopRight
* insideBottomRight
## Related Directives
Other directives that have an impact on the rendering of @series-labels
### @formats
Series formats of `currency` , `percent`, `integer`, & `decimal` will also apply the same styling rules to the series labels
## Use Cases
Adding series labels is helpful when you intend to review the actual value for each item in a series, rather than just look at the overall trend. It is easier to read the label then to have to scan the axis values. The downside of labels is they add more visual clutter to the visualization. You should only use series labels when there are not too many elements and the value of each series item is always important to see at a glance.
## Example Charts
