> ## Documentation Index
> Fetch the complete documentation index at: https://cubed3-igor-docs-cartesian-chart-builder.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Axes & series style

> Configure axis sections in the Style tab — measure appearance, titles, grid lines, label formatting, scale, and reference lines.

The **Style** tab of a bar, line, area, or scatter chart is a flat list of sections in chart order:
one section per axis in use, then [data labels](/docs/explore-analyze/charts/configuration/data-labels),
then the [legend](/docs/explore-analyze/charts/configuration/color-and-stacking#legend).

## Axis sections

A measure axis gets a section for each side a measure uses. Its title names the side:

| Title                             | When                                               |
| --------------------------------- | -------------------------------------------------- |
| **Y-Axis**                        | Every measure is on one side of a vertical chart   |
| **Left Y-Axis**, **Right Y-Axis** | Both sides of a vertical chart are in use          |
| **X-Axis**                        | Every measure is on one side of a horizontal chart |
| **Bottom X-Axis**, **Top X-Axis** | Both sides of a horizontal chart are in use        |

Below the measure axes comes the dimension axis — **X-Axis** on a vertical chart, **Y-Axis** on a
horizontal one.

Each section holds one row per measure drawn against that axis, then the axis's own settings.

## Measure appearance

A measure's row inside its axis section is labeled with its mark glyph and name, followed by the
controls that apply to that mark:

| Control           | Applies to                                 | Options                                                                                                                         |
| ----------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **Palette**       | A measure broken down by a dimension       | The built-in palettes and a custom one — see [palettes](/docs/explore-analyze/charts/configuration/color-and-stacking#palettes) |
| **Color**         | A measure with no break-down               | A single color swatch                                                                                                           |
| **Line style**    | Line marks                                 | **Solid**, **Dashed**, **Dotted**                                                                                               |
| **Point shape**   | Line marks                                 | **Circle**, **Square**, **Triangle**, **Diamond**, **None**                                                                     |
| **Shape**         | Scatter marks                              | The same five shapes                                                                                                            |
| **Interpolation** | Line and area marks                        | **Linear**, **Step**, **Smooth**                                                                                                |
| **Trend line**    | Any measure on a time or numeric dimension | On or off                                                                                                                       |

Line style and point shape both default to **Auto**. Auto line style assigns styles by list order, so
measures sharing a color scale can still be told apart. Auto point shape draws a marker-free line;
on a scatter mark it assigns shapes by list order.

A **Trend line** adds a dashed least-squares regression line in the measure's color — one per series
when the measure is broken down. It needs a time or numeric dimension to regress against, and is
disabled with a reason on an ordinal one.

## Axis settings

Every axis section carries the same controls:

| Setting                         | Description                                                      |
| ------------------------------- | ---------------------------------------------------------------- |
| **Show the axis**               | Draw the axis or hide it                                         |
| **Grid lines**                  | Draw grid lines perpendicular to the axis                        |
| **Tick labels**                 | Draw the axis tick labels                                        |
| **Axis title**                  | Override the title — the default is the measures' names          |
| **Label angle**                 | **Horizontal labels**, **Labels at 45°**, or **Vertical labels** |
| **Label format**                | **Number**, **Percentage**, **Currency**, or **Date**            |
| **Thin out overlapping labels** | Drop labels rather than let them collide                         |

A measure axis additionally controls its scale:

| Setting               | Description                                                                                                                          |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Logarithmic scale** | Draw the axis on a log scale. Needs values above zero, and is disabled with a reason when the side's data holds a zero or a negative |
| **Min** / **Max**     | Pin the scale's ends. Leave either empty to let it scale to the data                                                                 |

Min and Max are not offered on a side stacked to 100%, whose scale is fixed by definition.

### The same scale on both sides

When both sides of a chart are in use, the second section's header carries a **Same scale as the left
axis** toggle — **Same scale as the bottom axis** on a horizontal chart. Turning it on draws both
sides against one shared scale, so the two series are directly comparable rather than each filling
the plot height.

A [period-over-period comparison](/docs/explore-analyze/workbooks/querying-data#period-over-period-comparison)
column of a measure already on the chart takes the shared scale by default: comparing a measure with
its own earlier values is only meaningful on one scale.

## Reference lines

A reference line marks a target, threshold, or benchmark. Add one from the **Axis actions** menu (⋮)
in any axis header: **Add reference line**. Every axis with a scale can carry them, measure axes and
the dimension axis alike, and each axis can carry several, configured independently.

A reference line takes:

1. A **Value** — where the line sits on that axis.
2. An optional **Label** naming it, for example `Target 18k`.
3. A **Color**, **Line width**, and **Line style** (solid, dashed, or dotted).

### Reference line labels

A reference line with no label renders as a bare rule — the reader has to already know what it
means. Type text into **Label** to name it.

Once a label is set, two alignment controls appear next to it:

| Control        | Options              | Description                             |
| -------------- | -------------------- | --------------------------------------- |
| **Horizontal** | Start / Middle / End | Where along the line the text sits      |
| **Vertical**   | Above / Below        | Which side of the line the text sits on |

New labels start at **End** and **Above** — the right end of the line, clear of the bars. The label
takes the line's color, so it always reads as part of that line. Clearing the label removes the text
and leaves the line itself untouched.

<Tip>
  A label on a line near the top or bottom edge of the plot flips to the other side of the line
  automatically, so the text stays inside the chart area.
</Tip>

## Style settings survive Fields edits

Axis settings belong to the axis side, not to the measure that happens to be drawn against it. An
axis title, a log scale, a pinned Min and Max, or a legend position set on the Style tab is unchanged
when you reorder the measures, change a mark, or add a measure on the Fields tab.
