# @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
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.chartsql.com/reference/directives/series-labels.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.