docs: chart builder Fields and Style tabs for bar, line, area and scatter charts

docs-mintlify/docs.json

@@ -86,11 +86,10 @@
                     "group": "Configure charts",
                     "root": "docs/explore-analyze/charts/configuration/index",
                     "pages": [
-                      "docs/explore-analyze/charts/configuration/series-mapping",
-                      "docs/explore-analyze/charts/configuration/series-configuration",
+                      "docs/explore-analyze/charts/configuration/fields",
+                      "docs/explore-analyze/charts/configuration/axes",
                       "docs/explore-analyze/charts/configuration/color-and-stacking",
                       "docs/explore-analyze/charts/configuration/small-multiples",
-                      "docs/explore-analyze/charts/configuration/axes",
                       "docs/explore-analyze/charts/configuration/tooltips",
                       "docs/explore-analyze/charts/configuration/data-labels"
                     ]
@@ -1288,6 +1287,14 @@
     {
       "source": "/api-reference/workbooks/update-published-dashboard-ai-widget-thread",
       "destination": "/api-reference/workbooks/update-workbook-dashboard"
+    },
+    {
+      "source": "/docs/explore-analyze/charts/configuration/series-mapping",
+      "destination": "/docs/explore-analyze/charts/configuration/fields"
+    },
+    {
+      "source": "/docs/explore-analyze/charts/configuration/series-configuration",
+      "destination": "/docs/explore-analyze/charts/configuration/fields"
     }
   ]
 }

docs-mintlify/docs/explore-analyze/charts/chart-types/area.mdx

@@ -9,30 +9,34 @@ Area charts add a filled region beneath the line. The fill communicates magnitud
 
 ### Stacked
 
-Each series is stacked on top of the previous one. The top edge shows the cumulative total; each filled band shows the individual contribution. Use this for part-to-whole breakdowns over time (e.g. revenue by product category over months).
+Break the measure down by a dimension and leave its placement at **Stacked**: the areas stack on each other. The top edge shows the cumulative total and each filled band its individual contribution. Use this for part-to-whole breakdowns over time, such as revenue by product category over months.
 
 {/* Screenshot: stacked area chart — total sale price by month, split by product category (4–5 stacked bands). Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
-### Percentage stacked (Stack %)
+### Stacked to 100%
 
-Each series is normalized to 100% at every X-axis value, showing proportional contribution over time. Use when relative share matters more than absolute volume.
+Set the placement to **Stacked to 100%** and the areas fill the full height at every position, showing proportional contribution over time. Use when relative share matters more than absolute volume.
 
 {/* Screenshot: percentage stacked area chart — same data normalized to 100%. Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
 ### Overlaid
 
-All series share the same baseline. Use only when series are clearly separated in value and you want to compare trajectories rather than totals — with many series, fills will occlude each other.
+Set the placement to **Overlaid** and the areas share the baseline. Use only when the series are clearly separated in value and you want to compare trajectories rather than totals — with many series, the fills occlude each other.
 
 {/* Screenshot: overlaid area chart — two series, clearly separated in value. Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
-## Stacking
+## Placement
 
-Set stacking behavior in the **Color & stacking** section of the Style tab. The **Stack**, **Stack %**, and **Overlay** options are the relevant modes for area charts.
+Placement is set on the measure's **Break down by** row in the Fields tab: **Stacked**, **Overlaid**, or **Stacked to 100%**. Each measure is placed independently. See [Fields](/docs/explore-analyze/charts/configuration/fields#break-down-by) for the full reference.
 
-{/* Screenshot: stacking dropdown in the Style tab. Place inline, 50% width, right-aligned. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
+{/* Screenshot: the placement segments on a measure's Break down by row — stacked, overlaid, stacked to 100%. Place inline, 50% width, right-aligned. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
-See [Color & stacking](/docs/explore-analyze/charts/configuration/color-and-stacking) for palette options and stacked segment sorting.
+See [Color & legend](/docs/explore-analyze/charts/configuration/color-and-stacking) for palette options.
+
+## Area appearance
+
+An area's row in its axis section on the Style tab carries an **Interpolation** picker — **Linear**, **Step**, or **Smooth** — and a **Trend line** toggle.
 
 ## Axis behavior
 
-Area charts use a temporal X axis for time dimensions — continuous and time-aware. For non-time fields, the axis is ordinal.
+Area charts use a temporal dimension axis for time dimensions — continuous and time-aware. For non-time fields, the axis is ordinal.

docs-mintlify/docs/explore-analyze/charts/chart-types/bar.mdx

@@ -9,70 +9,72 @@ Bar charts compare values across discrete categories. Use them when the magnitud
 
 ### Basic
 
-One dimension on the X axis, one measure on the Y axis. Each category gets a single bar.
+One dimension and one measure with no break-down. Each category gets a single bar.
 
 <Frame>
   <img src="https://ucarecdn.com/4181db03-8959-4753-a09d-12aa182d5309/" />
 </Frame>
 
 ### Grouped
 
-Each series renders as a separate cluster of bars side-by-side at every X-axis value. Best for comparing absolute values across multiple series at each category.
+Break the measure down by a dimension and set its placement to **Side by side**: each value gets its own bar within the category's band. Best for comparing absolute values across several series at each category.
 
 {/* Screenshot: grouped bar chart — order count by status, grouped by product category. Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
 ### Stacked
 
-Series are stacked on top of each other at each X-axis value. Use when you want to show both individual contributions and the total at a glance.
+Break the measure down and leave its placement at **Stacked**: the values stack inside each bar. Use when you want to show both individual contributions and the total at a glance.
 
 {/* Screenshot: stacked bar chart — revenue by product category stacked by order status. Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
-### Percentage stacked (Stack %)
+### Stacked to 100%
 
-Each stack is normalized to 100%, showing each series as a proportion of the total per X-axis value. Use when relative distribution matters more than absolute values.
+Set the placement to **Stacked to 100%** and every bar is stretched to the full height, showing each value as a proportion of the category's total. Use when relative distribution matters more than absolute values.
 
 {/* Screenshot: percentage stacked bar — same data as stacked but normalized to 100%. Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
 ### Horizontal
 
-All three vertical variants are also available horizontally. Horizontal bars work well for long category labels, many categories, or when a left-to-right reading direction feels more natural.
+All three vertical variants are also available horizontally — flip the chart with the orientation switch in the **Dimension** section of the Fields tab. Horizontal bars work well for long category labels, many categories, or when a left-to-right reading direction feels more natural.
 
 {/* Screenshot: horizontal stacked bar chart. Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
 ### Composite (bar + line)
 
-Assign one series to the right Y axis and set its mark type to **Line** in [series configuration](/docs/explore-analyze/charts/configuration/series-configuration). This creates a dual-axis chart — useful for overlaying a rate on top of volume data (e.g. order count as bars, revenue per order as a line).
+Add a second measure from the **Measure actions** menu, set its mark to **Line**, and assign it to the right axis. This gives a dual-axis chart — useful for overlaying a rate on top of volume data, such as order count as bars and revenue per order as a line. The chart type reads **Composite** once the marks differ.
 
 {/* Screenshot: composite bar+line chart with dual Y axes — order count (bars, left axis) and average order value (line, right axis). Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
-## Stacking
+## Placement
 
-Stacking behavior is set in the **Color & stacking** section of the Style tab:
+How a broken-down measure's values sit relative to each other is set by the placement control on that measure's **Break down by** row in the Fields tab:
 
 | Option | Behavior |
 |---|---|
-| **Automatic** | Cube picks the best option based on your data |
-| **Stack** | Series at the same X value are stacked |
-| **Group** | Series at the same X value are placed side-by-side |
-| **Overlay** | Series are drawn on top of each other (rarely useful for bars) |
-| **Stack %** | Series are stacked and normalized to 100% |
+| **Stacked** | The values stack inside each bar |
+| **Side by side** | One bar per value |
+| **Stacked to 100%** | Each bar stretched to the full height |
 
-Stacking can also be set independently per Y-axis series — enabling grouped clusters of stacked sub-groups.
+Each measure is placed independently, so one can stack while another sits side by side. Two bar measures on the same axis are already drawn side by side within each band, one per measure, so the side-by-side placement is unavailable there.
 
-{/* Screenshot: stacking dropdown open in the Style tab showing all five options. Place inline, 50% width, right-aligned. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
+See [Fields](/docs/explore-analyze/charts/configuration/fields#break-down-by) for the full reference.
+
+{/* Screenshot: the placement segments on a measure's Break down by row — stacked, side by side, stacked to 100%. Place inline, 50% width, right-aligned. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
 ## Data labels
 
-Bar charts support totals labels on stacked charts — showing the aggregate value above each full stack. Enable **Data Labels** in the Fields tab, then configure:
+A bar is labeled with its total at the end of the bar. Turn on **Show data labels** in the **Data labels** section of the Style tab, then configure:
 
-- **Format** — number format applied to the label value
+- **Data label position** — inside or outside the bar end
+- **Label format** — number, percentage, currency, or date
 - **Font size** — size of the label text
-- **Position** — Outside end, Inside end, Inside center, or Inside base
 
-{/* Screenshot: stacked bar with total labels above each stack, Fields tab open showing Data Labels toggle enabled and Position set to "Outside end". Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
+See [Data labels](/docs/explore-analyze/charts/configuration/data-labels) for the full reference.
+
+{/* Screenshot: stacked bar with total labels at each bar end, Style tab open showing Data labels on and the position set outside the bar end. Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
 ## Axis behavior
 
-Bar charts use an ordinal X axis — each bar is labeled independently, the axis is not time-aware, and categories not present in the result set are not plotted. With time fields, bars are ordered ascending automatically. For other data types, order follows the results table sort.
+Bar charts use an ordinal dimension axis — each bar is labeled independently, the axis is not time-aware, and categories not present in the result set are not plotted. With time fields, bars are ordered ascending automatically. For other data types, order follows the results table sort.
 
 Tooltips on stacked bars are scoped to the segment under the cursor, not the full stack total.

docs-mintlify/docs/explore-analyze/charts/chart-types/heatmap.mdx

@@ -19,7 +19,7 @@ A continuous gradient palette is applied by default — low values map to the li
 
 {/* Screenshot: Style tab Color section open — showing the palette picker and Reverse colors toggle. Place inline, 50% width, right-aligned. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
-For custom palettes, see [Color & stacking](/docs/explore-analyze/charts/configuration/color-and-stacking).
+For custom palettes, see [Color & legend](/docs/explore-analyze/charts/configuration/color-and-stacking).
 
 ## Data structure
 

docs-mintlify/docs/explore-analyze/charts/chart-types/line.mdx

@@ -15,28 +15,43 @@ One measure plotted against a time or ordered dimension. The simplest and most c
 
 ### Multi-series
 
-Multiple lines plotted on the same axes. Map a second dimension to the **Color** channel to split one measure into one line per dimension value, or add multiple measures to the Y axis to plot them as separate series.
+Multiple lines plotted on the same axes. Pick a dimension in the measure's **Break down by** row to split it into one line per dimension value, or add more measures to plot them as separate series.
 
 {/* Screenshot: multi-series line chart — order count by week, split by order status (3–4 colored lines). Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
 ### With reference line
 
-A horizontal reference line marks a target, threshold, or benchmark. Added via the **Axes** section of the Style tab.
+A reference line marks a target, threshold, or benchmark. Add one from the axis's **Axis actions** menu on the Style tab.
 
 {/* Screenshot: line chart with a dashed reference line at a target value, label visible on the right side of the line. Place directly below this heading, full-width. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
+## Line appearance
+
+A line's row in its axis section on the Style tab carries the controls that shape it:
+
+| Control | Options |
+|---|---|
+| **Line style** | **Solid**, **Dashed**, **Dotted** — Auto assigns styles by list order |
+| **Point shape** | **Circle**, **Square**, **Triangle**, **Diamond**, **None** — Auto draws a marker-free line |
+| **Interpolation** | **Linear**, **Step**, **Smooth** |
+| **Trend line** | A dashed least-squares regression line in the measure's color |
+
+Line style earns its keep on a chart where color already belongs to a break-down: it tells the measures apart when their colors cannot.
+
 ## Reference lines
 
-Add a horizontal reference line in the **Y axis** section of the Style tab. Set the value, label, color, and line style (solid, dashed, or dotted). A labelled line also takes horizontal (start / middle / end) and vertical (above / below) placement for its text. Multiple reference lines are supported.
+Add a reference line from the **Axis actions** menu (⋮) in any axis header on the Style tab. Set the value, label, color, line width, and line style. A labeled line also takes horizontal (start / middle / end) and vertical (above / below) placement for its text. Multiple reference lines are supported on the same axis.
 
 {/* Screenshot: reference line configuration panel open — value field, label field, style dropdown. Place inline, 50% width, right-aligned. (hidden — replace this comment with <Frame><img src="..." /></Frame> when image is ready) */}
 
-See [Axes](/docs/explore-analyze/charts/configuration/axes) for the full configuration reference.
+See [Axes & series style](/docs/explore-analyze/charts/configuration/axes) for the full configuration reference.
 
 ## Axis behavior
 
-Line charts use a temporal X axis for time dimensions — continuous, time-aware, and not constrained to the result set. For non-time dimensions, the axis is ordinal and follows the result set sort order. Gaps in the line indicate missing data points.
+Line charts use a temporal dimension axis for time dimensions — continuous, time-aware, and not constrained to the result set. For non-time dimensions, the axis is ordinal and follows the result set sort order. Gaps in the line indicate missing data points.
+
+A line is drawn against a category axis whenever the chart also draws a bar, so the two marks always agree on the same bands.
 
 ## Combining with bars
 
-To layer a line on top of a bar chart, add a second series to the Y axis, set its mark type to **Line** in [series configuration](/docs/explore-analyze/charts/configuration/series-configuration), and assign it to the right Y axis for a dual-axis layout.
+Add a second measure from the **Measure actions** menu on the Fields tab, set its mark to **Line**, and assign it to the right axis for a dual-axis layout. The chart type reads **Composite** once the marks differ.

docs-mintlify/docs/explore-analyze/charts/chart-types/map.mdx

@@ -44,7 +44,7 @@ Optional:
 
 ### Point color
 
-When no **Color** field is assigned, all points render in the configurable **Default color**. When a dimension is assigned, each unique value gets a distinct color from the active palette — pick from the built-in palettes or supply a custom one, see [Color and stacking](/docs/explore-analyze/charts/configuration/color-and-stacking).
+When no **Color** field is assigned, all points render in the configurable **Default color**. When a dimension is assigned, each unique value gets a distinct color from the active palette — pick from the built-in palettes or supply a custom one, see [Color & legend](/docs/explore-analyze/charts/configuration/color-and-stacking).
 
 ### Point size
 
@@ -67,7 +67,7 @@ Built-in sources expose a fixed list of allowed properties. **Custom** lets you
 
 When the chart enters Region mode, the join dimension and measure are auto-picked when an unambiguous match exists in your query.
 
-The choropleth gradient comes from the active palette — pick from the built-in palettes or supply a custom one, see [Color and stacking](/docs/explore-analyze/charts/configuration/color-and-stacking).
+The choropleth gradient comes from the active palette — pick from the built-in palettes or supply a custom one, see [Color & legend](/docs/explore-analyze/charts/configuration/color-and-stacking).
 
 ### Custom GeoJSON