# Welcome to Chart plugin

Quick overview of Chart plugin and its features.

Chart Plugin helps designers (and many others) build clean, on-brand charts without leaving their canvas (Figma, Sketch). This guide is written for visual designers who may not be data viz experts but need to craft charts quickly—and keep them consistent with their company’s style.

{% embed url="<https://www.loom.com/share/f1bbb81595cf45baa6f547de27221e58?sid=6a1b7b6f-62d0-4a7b-8267-fb936b26e75c>" %}

### What you can do here

* Generate polished charts from sample data in a couple of clicks.
* Connect live Google Sheets or upload CSV/JSON data.
* Apply saved style templates to enforce brand consistency.
* Tweak chart settings before you insert the final result into Figma/Sketch.

Start exploring Chart's features by [creating your first chart](/how-to-create-your-first-chart). If you work with real data see how Chart could help you with Google Sheet or CSV integrations and API or JSON data.&#x20;

Working on your design system and want to create charting library? Go and see [how Chart could help you with this](/manage-charts-style/using-a-template).

If you have a question ask us via <hello@chartplugin.com>


# How to Activate your subscription

If you have paid for a subscription to the Chart [on our website](https://chartplugin.com/subscribe.html), you need to Activate it in Figma/Sketch. To do that just open Chart Plugin, click Activate in Status bar and enter the License key that was sent to your email or Email used for payment. Then click Update status:

<figure><img src="/files/OCyIIQbPKmsiwtzzISEa" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6cg1vNijfXdU9fOLKoDI" alt=""><figcaption></figcaption></figure>

If the Status has not updated within a couple of seconds, please email us (<hello@chartplugin.com>) to resolve the possible issue.


# How to Create your first chart

Start drawing your first chart in a seconds.

### Create your first chart

Just a few clicks and your first chart in Figma or Slides is ready:

{% embed url="<https://www.loom.com/share/660f44574ac040efb60a67d1096bb4ba?sid=8b10d6af-7e55-494b-975c-2a31b2089808>" %}

Now that you know how Chart works, choose the type of chart you want to create:

* [Line chart](/how-to-create-your-first-chart/create-line-chart)
* [Area chart](/how-to-create-your-first-chart/create-area-chart)
* [Stacked Area chart](/how-to-create-your-first-chart/create-stacked-area-chart)
* [Stream graph](/how-to-create-your-first-chart/create-stream-graph)
* [Vertical Bar chart (+stacked option)](/how-to-create-your-first-chart/create-vertical-bar-chart)
* [Horizontal Bar chart  (+stacked option)](/how-to-create-your-first-chart/create-horizontal-bar-chart)
* [Grouped Bar chart](/how-to-create-your-first-chart/create-grouped-bar-chart)
* [Grouped Horizontal Bar chart](/how-to-create-your-first-chart/create-grouped-horizontal-bar-chart)
* [Pie chart](/how-to-create-your-first-chart/create-pie-chart)
* [Donut chart](/how-to-create-your-first-chart/create-donut-chart)
* [Progress chart](/how-to-create-your-first-chart/create-progress-chart)
* [Scatter plot](/how-to-create-your-first-chart/create-scatter-plot)
* [Bubble chart](/how-to-create-your-first-chart/create-bubble-chart)
* [Sparkline](/how-to-create-your-first-chart/create-sparkline)
* [Candlestick chart](/how-to-create-your-first-chart/create-candlestick-chart)
* [Histogram](/how-to-create-your-first-chart/create-histogram)
* [Heatmap](/how-to-create-your-first-chart/create-heatmap)
* [Radar chart](/how-to-create-your-first-chart/create-radar-chart)
* [Waterfall chart](/how-to-create-your-first-chart/create-waterfall-chart)
* [Multitype chart](/how-to-create-your-first-chart/create-multitype-chart)

If you don't find the type of chart you need, just write to us (<hello@chartplugin.com>) and we will add it to our roadmap.


# Create Line chart

Everything you need to know to create the chart you want.

### Overview

Line charts connect data points over a continuous axis (usually time) to highlight trends and direction. They’re ideal for showing how a metric changes across evenly spaced intervals.

### When to use it

* Tracking performance over weeks, months, or releases.
* Comparing a handful (≤4) of series without overwhelming the viewer.
* Highlighting growth/decline patterns or seasonality.

Avoid line charts when categories are non-sequential or when you have dozens of series—switch to a heatmap or bar chart instead.

### Data requirements

* At least one numeric series.
* Categories in sequential order (e.g., time, ordered stages).
* Supports multiple series; each series shares the same categories.

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Line         | Type                    | select     | line, spline                                                                                                         | Selects the exact chart variant rendered for this series (line or spline).         |
| General → Line         | Line width              | number     | —                                                                                                                    | Thickness of the line or outline in pixels.                                        |
| General → Line         | Line style              | select     | Solid, Dash, Dot                                                                                                     | Dash pattern applied to lines.                                                     |
| General → Line         | Show dots               | boolean    | —                                                                                                                    | Toggles the display of point markers on lines or areas.                            |
| General → Line         | Radius of dots          | number     | —                                                                                                                    | Radius of markers drawn on the line chart in pixels.                               |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → X Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → X Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → X Axis          | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label   | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels      | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the horizontal axis scale (category, numeric, logarithmic, or datetime).      |
| Axes → X Axis          | Tick placement          | select     | on, between                                                                                                          | Whether ticks sit on category positions or between them.                           |
| Axes → X Axis          | Point placement         | select     | on, between                                                                                                          | Positions points inside their category slot (on the tick or between ticks).        |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Area chart

Everything you need to know to create the chart you want.

### Overview

Area charts fill the space beneath a line to emphasise volume or magnitude over time. They retain the trend clarity of line charts while conveying accumulated value.

### When to use it

* Showing total volume where the area under the curve matters (e.g., hours logged, revenue).
* Comparing up to three series with clear differences.
* Highlighting change intensity rather than precise values.

Avoid area charts when series overlap heavily—stacked area charts or line charts may read better.

### Data requirements

* Sequential categories (time, ordered stages).
* One or more numeric series.
* All series share the same category axis.

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Area         | Type                    | select     | area, areaspline                                                                                                     | Selects the exact chart variant rendered for this series (line or spline).         |
| General → Area         | Line width              | number     | —                                                                                                                    | Thickness of the line or outline in pixels.                                        |
| General → Area         | Line style              | select     | Solid, Dash, Dot                                                                                                     | Dash pattern applied to lines.                                                     |
| General → Area         | Show dots               | boolean    | —                                                                                                                    | Toggles the display of point markers on lines or areas.                            |
| General → Area         | Radius of dots          | number     | —                                                                                                                    | Radius of markers drawn on the line chart in pixels.                               |
| General → Area         | Fill opacity (0...1)    | number     | —                                                                                                                    | Opacity of the area fill; 1 is solid, 0 is fully transparent.                      |
| General → Area         | Gradient fill           | boolean    | —                                                                                                                    | Toggles gradient fills instead of flat colour.                                     |
| General → Area         | Gradient start opacity  | number     | —                                                                                                                    | Opacity of the gradient at the start point.                                        |
| General → Area         | Gradient end opacity    | number     | —                                                                                                                    | Opacity of the gradient at the end point.                                          |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → X Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → X Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → X Axis          | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label   | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels      | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the horizontal axis scale (category, numeric, logarithmic, or datetime).      |
| Axes → X Axis          | Tick placement          | select     | on, between                                                                                                          | Whether ticks sit on category positions or between them.                           |
| Axes → X Axis          | Point placement         | select     | on, between                                                                                                          | Positions points inside their category slot (on the tick or between ticks).        |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

> 🎨 **Tip:** Lower the fill opacity to 50–70% when plotting multiple area series to avoid visual clutter.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Stacked Area chart

Everything you need to know to create the chart you want.

### Overview

Stacked area charts layer multiple area series on top of each other, revealing both the total trend and each series’ contribution. They’re great for composition over time.

### When to use it

* Displaying how parts add up to a whole (e.g., revenue by product line).
* Tracking proportional changes while keeping an eye on totals.
* Highlighting dominant contributors and shifts in share.

Avoid stacked areas if categories are unordered or if negative values are common; the visual hierarchy can become confusing.

### Data requirements

* Sequential categories shared across all series.
* Numeric series that combine into a cumulative total.
* Preferably positive values to maintain readable stacking.

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Stacked area | Type                    | select     | area, areaspline                                                                                                     | Selects the exact chart variant rendered for this series (line or spline).         |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → X Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → X Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → X Axis          | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label   | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels      | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the horizontal axis scale (category, numeric, logarithmic, or datetime).      |
| Axes → X Axis          | Tick placement          | select     | on, between                                                                                                          | Whether ticks sit on category positions or between them.                           |
| Axes → X Axis          | Point placement         | select     | on, between                                                                                                          | Positions points inside their category slot (on the tick or between ticks).        |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Stream graph

Everything you need to know to create the chart you want.

### Overview

Streamgraphs are stacked area charts with a flowing, central baseline. They highlight fluctuations in contributions over time while keeping the visual organic and balanced around the centre.

### When to use it

* Storytelling dashboards where visual impact matters (music genres over time, content categories).
* Comparing relative share without needing exact totals.
* Showing smooth, continuous change with many categories.

Avoid streamgraphs when precise values are required or when your audience needs to compare small differences.

### Data requirements

* Sequential categories (usually time).
* Multiple numeric series (ideally positive).
* Best with smoothed data to avoid jittery shapes.

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → X Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → X Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → X Axis          | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label   | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels      | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the horizontal axis scale (category, numeric, logarithmic, or datetime).      |
| Axes → X Axis          | Tick placement          | select     | on, between                                                                                                          | Whether ticks sit on category positions or between them.                           |
| Axes → X Axis          | Point placement         | select     | on, between                                                                                                          | Positions points inside their category slot (on the tick or between ticks).        |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Vertical Bar chart

Everything you need to know to create the chart you want.

### Overview

Column charts (vertical bars) compare discrete categories side by side. They’re excellent for highlighting differences in magnitude across a small to medium set of items. Use more than one series of data to get stacked version of Vertical bar chart.

### When to use it

* Comparing values across categories (e.g., revenue by region).
* Showing change over time with a small number of periods.
* Emphasising absolute differences rather than proportions.

Avoid column charts for very long category lists—consider a horizontal bar chart instead.

### Data requirements

* One or more numeric series.
* Categories can be nominal (unordered) or ordinal.
* Series share the same categories; each category appears once per series.

### Style options available

| Group                  | Control                     | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | --------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette               | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Bars         | Margin between bars (0...1) | number     | —                                                                                                                    | Relative gap between bars inside one category (0 = touching, 1 = wide spacing).    |
| General → Bars         | Round bars, px              | number     | —                                                                                                                    | Radius applied to round off bar or column corners (in pixels).                     |
| General → Bars         | Corners to round            | select     | end, all                                                                                                             | Defines radius for rounding column or bar corners in pixels.                       |
| General → Bars         | Color each column           | boolean    | —                                                                                                                    | Assigns a unique colour to every column instead of sharing a palette per series.   |
| General → Bars         | Margin between stacked bars | number     | —                                                                                                                    | Gap between stacked series blocks when columns are grouped.                        |
| General → Data labels  | Show data labels            | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap     | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis                 | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width             | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width             | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color             | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color             | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style             | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Allow labels to overlap     | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label       | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels          | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Opposite side               | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title            | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis                 | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width             | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width             | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color             | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color             | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style             | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width                  | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length                 | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color                  | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment            | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                    | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                    | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                        | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side               | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title            | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin               | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin               | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend                 | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align            | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align              | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                      | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend           | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items        | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items     | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items      | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom               | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

> 📊 **Tip:** Align columns with the visual rhythm of your layout grid; consistent spacing keeps dashboards tidy.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Horizontal Bar chart

Everything you need to know to create the chart you want.

### Overview

Bar charts flip columns horizontally, making them perfect for ranked comparisons or long category labels. They emphasise relative length, aiding quick scanning. Use more than one series of data to get stacked version of Horizontal bar chart.

### When to use it

* Ranking items (top customers, feature usage).
* Displaying categories with long text labels.
* Comparing up to 10–12 categories without overwhelming the viewer.

Avoid bar charts when you need to show time-based trends—choose line or column charts instead.

### Data requirements

* One or more numeric series.
* Categories can be categorical or ordered.
* Works best when sorted (ascending or descending) for readability.

### Style options available

| Group                  | Control                     | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | --------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette               | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Bars         | Margin between bars (0...1) | number     | —                                                                                                                    | Relative gap between bars inside one category (0 = touching, 1 = wide spacing).    |
| General → Bars         | Round bars, px              | number     | —                                                                                                                    | Radius applied to round off bar or column corners (in pixels).                     |
| General → Bars         | Corners to round            | select     | end, all                                                                                                             | Defines radius for rounding column or bar corners in pixels.                       |
| General → Bars         | Color each column           | boolean    | —                                                                                                                    | Assigns a unique colour to every column instead of sharing a palette per series.   |
| General → Bars         | Margin between stacked bars | number     | —                                                                                                                    | Gap between stacked series blocks when columns are grouped.                        |
| General → Data labels  | Show data labels            | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap     | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis                 | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width             | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width             | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color             | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color             | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style             | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Allow labels to overlap     | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label       | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels          | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Opposite side               | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title            | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis                 | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width             | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width             | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color             | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color             | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style             | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width                  | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length                 | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color                  | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment            | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                    | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                    | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                        | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side               | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title            | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin               | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin               | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend                 | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align            | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align              | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                      | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend           | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items        | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items     | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items      | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom               | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name                   | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style                  | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size                   | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color                  | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Grouped Bar chart

Everything you need to know to create the chart you want.

### Overview

Grouped column charts (vertical bars) place series side by side within each category, making it easy to compare sub-groups directly. Think of them as mini-clusters of columns per category.

### When to use it

* Comparing metrics across categories and segments simultaneously (e.g., revenue by region and channel).
* Highlighting changes between two states (before/after).
* Visualising survey results split by demographic groups.

Avoid grouped columns if you have more than 4 series per category—the chart becomes dense and hard to read.

### Data requirements

* Categories along the x-axis.
* Multiple series, each representing a sub-category.
* All series share the same categories.

### Style options available

| Group                  | Control                       | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette                 | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Bars         | Margin between bars (0...1)   | number     | —                                                                                                                    | Relative gap between bars inside one category (0 = touching, 1 = wide spacing).    |
| General → Bars         | Margin between groups (0...1) | number     | —                                                                                                                    | Relative gap between grouped bar clusters.                                         |
| General → Bars         | Round bars, px                | number     | —                                                                                                                    | Radius applied to round off bar or column corners (in pixels).                     |
| General → Bars         | Corners to round              | select     | end, all                                                                                                             | Defines radius for rounding column or bar corners in pixels.                       |
| General → Data labels  | Show data labels              | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap       | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis                   | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width               | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width               | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color               | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color               | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style               | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Allow labels to overlap       | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label         | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels            | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Opposite side                 | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title              | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis                   | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width               | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width               | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color               | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color               | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style               | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width                    | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length                   | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color                    | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment              | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                      | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                      | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                          | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side                 | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title              | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin                 | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin                 | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend                   | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align              | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align                | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                        | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend             | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items          | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items       | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items        | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom                 | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

> 📐 **Tip:** Keep subgroup order consistent across dashboards (e.g., always left-to-right: Q1, Q2, Q3, Q4) to reinforce pattern recognition.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Grouped Horizontal Bar chart

Everything you need to know to create the chart you want.

### Overview

Grouped Horizontal bar charts display horizontal clusters of bars so you can compare sub-groups across categories. They’re especially handy when category labels are long.

### When to use it

* Comparing metrics across categories where labels require extra space.
* Analysing survey responses split by demographics.
* Highlighting differences between current vs. target values.

Avoid grouped bars if you have many series—the chart widens quickly and becomes hard to scan.

### Data requirements

* Ordered or unordered categories on the y-axis.
* Multiple numeric series per category.
* Data should be sorted for readability (optional but recommended).

### Style options available

| Group                  | Control                       | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette                 | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Bars         | Margin between bars (0...1)   | number     | —                                                                                                                    | Relative gap between bars inside one category (0 = touching, 1 = wide spacing).    |
| General → Bars         | Margin between groups (0...1) | number     | —                                                                                                                    | Relative gap between grouped bar clusters.                                         |
| General → Bars         | Round bars, px                | number     | —                                                                                                                    | Radius applied to round off bar or column corners (in pixels).                     |
| General → Bars         | Corners to round              | select     | end, all                                                                                                             | Defines radius for rounding column or bar corners in pixels.                       |
| General → Data labels  | Show data labels              | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap       | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis                   | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width               | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width               | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color               | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color               | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style               | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Allow labels to overlap       | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label         | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels            | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Opposite side                 | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title              | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis                   | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width               | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width               | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color               | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color               | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style               | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width                    | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length                   | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color                    | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment              | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                      | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                      | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                          | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side                 | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title              | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin                 | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin                 | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend                   | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align              | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align                | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                        | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend             | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items          | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items       | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items        | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom                 | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

> 📏 **Tip:** Align grouped bars with your layout grid to maintain a clean visual rhythm across dashboards.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Pie chart

Everything you need to know to create the chart you want.

### Overview

Pie charts display parts of a whole as slices around a circle. They’re best for showing simple composition where there are few categories and a clear story.

### When to use it

* Illustrating percentage breakdowns with ≤5 slices.
* Highlighting a dominant slice versus the rest.
* Presenting categorical distribution in executive summaries.

Avoid pie charts for detailed comparisons, many categories, or values that don’t sum to a meaningful whole. Consider bar or stacked charts instead.

### Data requirements

* One series of positive values.
* Categories should represent mutually exclusive segments.
* Ideally, values sum to 100% (but not strictly required).

### Style options available

| Group                  | Control                 | Input type | Options                         | Description                                                                           |
| ---------------------- | ----------------------- | ---------- | ------------------------------- | ------------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                               | Palette applied to series; sets the default colours for the chart.                    |
| General → Pie          | Start angle, deg        | number     | —                               | Angle where circular charts begin drawing, in degrees.                                |
| General → Pie          | End angle, deg          | number     | —                               | Angle at which circular charts (pie, donut, gauge) stop drawing, measured in degrees. |
| General → Pie          | Margin between slices   | number     | —                               | Gap between adjacent pie or donut slices.                                             |
| General → Pie          | Enable sorting          | boolean    | —                               | Automatically sorts points by value before plotting.                                  |
| General → Data labels  | Show data labels        | boolean    | —                               | Shows numeric labels directly on data points.                                         |
| General → Data labels  | Distance from pie, %    | text       | —                               | How far a slice is pulled out from the centre as a percentage of radius.              |
| General → Data labels  | Show name of series     | boolean    | —                               | Shows series names alongside values (used in waterfall totals).                       |
| General → Data labels  | Allow labels to overlap | boolean    | —                               | Allows labels to render even if they collide instead of hiding them automatically.    |
| General → Data labels  | Font name               | text       | —                               | Font family used for titles, labels, or legend text.                                  |
| General → Data labels  | Font style              | text       | —                               | Font weight or style (e.g., bold, italic).                                            |
| General → Data labels  | Font size               | number     | —                               | Font size in pixels for the selected text element.                                    |
| General → Data labels  | Font color              | color      | —                               | Colour of the text shown for this element.                                            |
| Legend → Main          | Show legend             | boolean    | —                               | Shows or hides the legend box.                                                        |
| Legend → Main          | Horizontal align        | select     | left, center, right             | Horizontal alignment for the legend box (left, centre, right).                        |
| Legend → Main          | Vertical align          | select     | top, middle, bottom             | Vertical alignment for the legend box (top, middle, bottom).                          |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate | Orientation of the legend items (horizontal row, vertical column, or proximate).      |
| Legend → Additional    | Margin for legend       | number     | —                               | Outer margin around the legend box.                                                   |
| Legend → Additional    | Margin top for items    | number     | —                               | Top padding inside the legend between items.                                          |
| Legend → Additional    | Margin bottom for items | number     | —                               | Bottom padding inside the legend between items.                                       |
| Legend → Additional    | Distance between items  | number     | —                               | Horizontal spacing between legend entries.                                            |
| Legend → Style         | Font name               | text       | —                               | Font family used for titles, labels, or legend text.                                  |
| Legend → Style         | Font style              | text       | —                               | Font weight or style (e.g., bold, italic).                                            |
| Legend → Style         | Font size               | number     | —                               | Font size in pixels for the selected text element.                                    |
| Legend → Style         | Font color              | color      | —                               | Colour of the text shown for this element.                                            |
| Title → Chart title    | Font name               | text       | —                               | Font family used for titles, labels, or legend text.                                  |
| Title → Chart title    | Font style              | text       | —                               | Font weight or style (e.g., bold, italic).                                            |
| Title → Chart title    | Font size               | number     | —                               | Font size in pixels for the selected text element.                                    |
| Title → Chart title    | Font color              | color      | —                               | Colour of the text shown for this element.                                            |
| Title → Chart title    | Margin bottom           | number     | —                               | Extra space below chart titles or subtitles in pixels.                                |
| Title → Chart subtitle | Font name               | text       | —                               | Font family used for titles, labels, or legend text.                                  |
| Title → Chart subtitle | Font style              | text       | —                               | Font weight or style (e.g., bold, italic).                                            |
| Title → Chart subtitle | Font size               | number     | —                               | Font size in pixels for the selected text element.                                    |
| Title → Chart subtitle | Font color              | color      | —                               | Colour of the text shown for this element.                                            |

> 🍰 **Tip:** Sort slices from largest to smallest (clockwise) so the story is easy to grasp at a glance.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Donut chart

Everything you need to know to create the chart you want.

### Overview

Donut charts are pie charts with a hollow centre, giving you space for a headline metric. They retain the part-to-whole message while offering more flexibility for annotations.

### When to use it

* Displaying composition with a key total or KPI in the middle.
* Comparing a maximum of 5–6 segments.
* Creating compact dashboard tiles with a central callout.

Avoid donut charts when you need precise comparisons between slices or when the total isn’t meaningful.

### Data requirements

* Single series of positive values.
* Categories represent distinct slices.
* Total should ideally equal 100% for intuitive interpretation.

### Style options available

| Group                  | Control                 | Input type | Options                         | Description                                                                           |
| ---------------------- | ----------------------- | ---------- | ------------------------------- | ------------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                               | Palette applied to series; sets the default colours for the chart.                    |
| General → Donut        | Inner size, %           | text       | —                               | Inner radius for donut or gauge charts as a percentage of the outer radius.           |
| General → Donut        | Start angle, deg        | number     | —                               | Angle where circular charts begin drawing, in degrees.                                |
| General → Donut        | End angle, deg          | number     | —                               | Angle at which circular charts (pie, donut, gauge) stop drawing, measured in degrees. |
| General → Donut        | Margin between slices   | number     | —                               | Gap between adjacent pie or donut slices.                                             |
| General → Donut        | Enable sorting          | boolean    | —                               | Automatically sorts points by value before plotting.                                  |
| General → Data labels  | Show data labels        | boolean    | —                               | Shows numeric labels directly on data points.                                         |
| General → Data labels  | Allow labels to overlap | boolean    | —                               | Allows labels to render even if they collide instead of hiding them automatically.    |
| General → Data labels  | Font name               | text       | —                               | Font family used for titles, labels, or legend text.                                  |
| General → Data labels  | Font style              | text       | —                               | Font weight or style (e.g., bold, italic).                                            |
| General → Data labels  | Font size               | number     | —                               | Font size in pixels for the selected text element.                                    |
| General → Data labels  | Font color              | color      | —                               | Colour of the text shown for this element.                                            |
| Legend → Main          | Show legend             | boolean    | —                               | Shows or hides the legend box.                                                        |
| Legend → Main          | Horizontal align        | select     | left, center, right             | Horizontal alignment for the legend box (left, centre, right).                        |
| Legend → Main          | Vertical align          | select     | top, middle, bottom             | Vertical alignment for the legend box (top, middle, bottom).                          |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate | Orientation of the legend items (horizontal row, vertical column, or proximate).      |
| Legend → Additional    | Margin for legend       | number     | —                               | Outer margin around the legend box.                                                   |
| Legend → Additional    | Margin top for items    | number     | —                               | Top padding inside the legend between items.                                          |
| Legend → Additional    | Margin bottom for items | number     | —                               | Bottom padding inside the legend between items.                                       |
| Legend → Additional    | Distance between items  | number     | —                               | Horizontal spacing between legend entries.                                            |
| Legend → Style         | Font name               | text       | —                               | Font family used for titles, labels, or legend text.                                  |
| Legend → Style         | Font style              | text       | —                               | Font weight or style (e.g., bold, italic).                                            |
| Legend → Style         | Font size               | number     | —                               | Font size in pixels for the selected text element.                                    |
| Legend → Style         | Font color              | color      | —                               | Colour of the text shown for this element.                                            |
| Title → Chart title    | Font name               | text       | —                               | Font family used for titles, labels, or legend text.                                  |
| Title → Chart title    | Font style              | text       | —                               | Font weight or style (e.g., bold, italic).                                            |
| Title → Chart title    | Font size               | number     | —                               | Font size in pixels for the selected text element.                                    |
| Title → Chart title    | Font color              | color      | —                               | Colour of the text shown for this element.                                            |
| Title → Chart title    | Margin bottom           | number     | —                               | Extra space below chart titles or subtitles in pixels.                                |
| Title → Chart subtitle | Font name               | text       | —                               | Font family used for titles, labels, or legend text.                                  |
| Title → Chart subtitle | Font style              | text       | —                               | Font weight or style (e.g., bold, italic).                                            |
| Title → Chart subtitle | Font size               | number     | —                               | Font size in pixels for the selected text element.                                    |
| Title → Chart subtitle | Font color              | color      | —                               | Colour of the text shown for this element.                                            |

> 🧁 **Tip:** Use the empty centre to communicate context (“Total MRR”) or trend (+8% vs last month) for extra narrative punch.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Progress chart

Everything you need to know to create the chart you want.

### Overview

Progress (Solid gauges) display progress against a target using a circular arc. Think of them as minimalist speedometers for KPIs.

### When to use it

* Highlighting a single metric vs. goal (e.g., completion rate, NPS).
* Creating dashboard tiles where quick status recognition matters.
* Showing a range with clear minimum/maximum thresholds.

Avoid gauges when comparing many categories—use bar charts or sparklines instead.

### Data requirements

* Single numeric value.
* Works best with percentages or values bounded between min and max.

### Style options available

| Group                  | Control          | Input type | Options     | Description                                                        |
| ---------------------- | ---------------- | ---------- | ----------- | ------------------------------------------------------------------ |
| Colors                 | Color palette    | palette    | —           | Palette applied to series; sets the default colours for the chart. |
| General → Progress     | Inner size, %    | text       | —           | Inner radius of the filled gauge arc.                              |
| General → Progress     | Rounded ends     | boolean    | —           | Rounds the ends of the solid gauge arc for a pill-shaped look.     |
| General → Background   | Inner size, %    | text       | —           | Inner radius of the gauge background ring.                         |
| General → Background   | Start angle, deg | number     | —           | Angle where the gauge arc begins, in degrees.                      |
| General → Background   | End angle, deg   | number     | —           | Angle where the gauge arc ends, in degrees.                        |
| General → Background   | Type             | select     | circle, arc | Shape used for the gauge pane (e.g., solid arc).                   |
| General → Background   | Color            | color      | —           | Colour of the gauge background ring.                               |
| Title → Chart title    | Font name        | text       | —           | Font family used for titles, labels, or legend text.               |
| Title → Chart title    | Font style       | text       | —           | Font weight or style (e.g., bold, italic).                         |
| Title → Chart title    | Font size        | number     | —           | Font size in pixels for the selected text element.                 |
| Title → Chart title    | Font color       | color      | —           | Colour of the text shown for this element.                         |
| Title → Chart title    | Margin bottom    | number     | —           | Extra space below chart titles or subtitles in pixels.             |
| Title → Chart subtitle | Font name        | text       | —           | Font family used for titles, labels, or legend text.               |
| Title → Chart subtitle | Font style       | text       | —           | Font weight or style (e.g., bold, italic).                         |
| Title → Chart subtitle | Font size        | number     | —           | Font size in pixels for the selected text element.                 |
| Title → Chart subtitle | Font color       | color      | —           | Colour of the text shown for this element.                         |

> 🎯 **Tip:** Pair the progress with a concise subtitle (“Goal: 85%”) to give readers instant context.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Scatter plot

Everything you need to know to create the chart you want.

### Overview

Scatter plots show relationships between two numerical variables by plotting points on an x/y plane. They reveal correlations, clusters, and outliers.

### When to use it

* Exploring correlation between metrics (e.g., conversion rate vs. spend).
* Highlighting clusters in product usage or customer segments.
* Spotting outliers that merit discussion.

Avoid scatter plots when categories are categorical or when you only have one metric—line or bar charts will be clearer.

### Data requirements

* Each point needs an x-value and y-value.
* Use label or category per point for legends.

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Scatter plot | Radius of dots          | number     | —                                                                                                                    | Radius of markers drawn on the line chart in pixels.                               |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → X Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → X Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → X Axis          | Type                    | select     | linear, logarithmic                                                                                                  | Sets the horizontal axis scale (category, numeric, logarithmic, or datetime).      |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                    | select     | linear, logarithmic                                                                                                  | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Bubble chart

Everything you need to know to create the chart you want.

### Overview

Bubble charts extend scatter plots by adding a third dimension: marker size. Each bubble encodes X, Y, and size.

### When to use it

* Showing relationships between three metrics simultaneously (e.g., revenue vs. growth vs. market share).
* Highlighting standout segments in market analysis.
* Communicating scale alongside positioning.

Avoid bubble charts if the size differences are subtle or if you need precise comparisons—bar charts might tell the story more clearly.

### Data requirements

* X-value, Y-value, and bubble size for each point.
* Ensure bubble sizes are positive numbers.

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → X Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → X Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → X Axis          | Type                    | select     | linear, logarithmic                                                                                                  | Sets the horizontal axis scale (category, numeric, logarithmic, or datetime).      |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                    | select     | linear, logarithmic                                                                                                  | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

> 🫧 **Tip:** Sort data by size before importing if you want larger bubbles to render first or last—this affects overlapping order.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Sparkline

Everything you need to know to create the chart you want.

### Overview

Sparklines are tiny line charts without axes or labels. They provide a quick glance at trend direction inside tables or KPI cards.

### When to use it

* Embedding trend hints inside dashboards or status cards.
* Comparing multiple metrics in compact layouts.
* Highlighting the shape of change rather than exact numbers.

Avoid sparklines when precise values or annotations are required; use full line charts instead.

### Data requirements

* Sequential data (time or ordered stages).
* One series per sparkline; keep point counts reasonable (8–20).
* Provide context elsewhere (title, KPI text) since sparklines are minimalist.

### Style options available

| Group                  | Control       | Input type | Options      | Description                                                                |
| ---------------------- | ------------- | ---------- | ------------ | -------------------------------------------------------------------------- |
| Colors                 | Color palette | palette    | —            | Palette applied to series; sets the default colours for the chart.         |
| General → Sparkline    | Type          | select     | line, spline | Selects the exact chart variant rendered for this series (line or spline). |
| General → Sparkline    | Line width    | number     | —            | Thickness of the line or outline in pixels.                                |
| General → Sparkline    | Radius of dot | number     | —            | Radius of markers drawn on the line chart in pixels.                       |
| Title → Chart title    | Font name     | text       | —            | Font family used for titles, labels, or legend text.                       |
| Title → Chart title    | Font style    | text       | —            | Font weight or style (e.g., bold, italic).                                 |
| Title → Chart title    | Font size     | number     | —            | Font size in pixels for the selected text element.                         |
| Title → Chart title    | Font color    | color      | —            | Colour of the text shown for this element.                                 |
| Title → Chart title    | Margin bottom | number     | —            | Extra space below chart titles or subtitles in pixels.                     |
| Title → Chart subtitle | Font name     | text       | —            | Font family used for titles, labels, or legend text.                       |
| Title → Chart subtitle | Font style    | text       | —            | Font weight or style (e.g., bold, italic).                                 |
| Title → Chart subtitle | Font size     | number     | —            | Font size in pixels for the selected text element.                         |
| Title → Chart subtitle | Font color    | color      | —            | Colour of the text shown for this element.                                 |

> ✨ **Tip:** Pair a sparkline with a headline metric and delta (“+4.2% vs last month”) for immediate insight.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Candlestick chart

Everything you need to know to create the chart you want.

### Overview

Candlestick charts track financial instruments by showing open, high, low, and close prices for each period. They highlight volatility and directional trends in a compact form.

### When to use it

* Displaying stock, crypto, or commodity price movements.
* Analysing volatility and identifying bullish/bearish patterns.
* Combining with volume or moving averages for richer analysis.

Avoid candlesticks for audiences unfamiliar with financial charting or when you lack OHLC data—use line charts instead.

### Data requirements

* Each category (e.g., day) must include `open`, `high`, `low`, and `close` values.
* Categories should be sequential (time-based).

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Candlestick  | Line color              | color      | —                                                                                                                    | Stroke colour for the series line or outline.                                      |
| General → Candlestick  | Up color                | color      | —                                                                                                                    | Fill colour for increasing candlesticks or bars.                                   |
| General → Candlestick  | Up line color           | color      | —                                                                                                                    | Stroke colour for the outline of increasing candlesticks.                          |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → X Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → X Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → X Axis          | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label   | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels      | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the horizontal axis scale (category, numeric, logarithmic, or datetime).      |
| Axes → X Axis          | Tick placement          | select     | on, between                                                                                                          | Whether ticks sit on category positions or between them.                           |
| Axes → X Axis          | Point placement         | select     | on, between                                                                                                          | Positions points inside their category slot (on the tick or between ticks).        |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Histogram

Everything you need to know to create the chart you want.

### Overview

Histograms group continuous data into bins and display the frequency of values within each range. They reveal distribution shape, skewness, and outliers.

### When to use it

* Analysing distribution of metrics (session length, order value).
* Identifying skew, multimodal patterns, or spread.
* Comparing distribution between two groups (with overlaid histograms or grouped columns).

Avoid histograms when categories are discrete and few—stick to bar charts instead.

### Data requirements

* Single numeric dataset; the plugin bins values automatically.
* Optional dataset name for legend.

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Histogram    | Margin between bars     | number     | —                                                                                                                    | Pixel gap between individual bars or columns.                                      |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label   | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels      | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

> 🧮 **Tip:** Combine with a summary stat (mean/median) in the chart subtitle to give readers immediate context.

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Heatmap

Everything you need to know to create the chart you want.

### Overview

Heatmaps visualise two categorical dimensions with colour intensity representing the magnitude of a metric. They’re ideal for spotting patterns, hotspots, or anomalies in dense data.

### When to use it

* Analysing performance across two axes (e.g., day of week × hour of day).
* Highlighting utilisation levels, error rates, or engagement.
* Communicating correlations in matrix form.

Avoid heatmaps when precise values matter more than pattern recognition; a table or bar chart may be clearer.

### Data requirements

* Categories for rows and columns.
* Numeric value for each cell; missing values default to null (shown as blanks).
* Larger datasets benefit from consistent ordering (e.g., chronological).

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Heatmap      | Border for cells        | number     | —                                                                                                                    | Colour of the borders around individual heatmap cells.                             |
| General → Heatmap      | Border color            | color      | —                                                                                                                    | Stroke colour drawn around each bar, column, or slice.                             |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → X Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → X Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → X Axis          | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label   | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels      | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Radar chart

Everything you need to know to create the chart you want.

### Overview

Radar (spider) charts plot multiple metrics on radial axes, connecting them to form a polygon. They make it easy to compare profiles or performance across qualitative dimensions.

### When to use it

* Comparing feature completeness across products.
* Visualising skill assessments or survey results across categories.
* Highlighting strengths and weaknesses in a balanced scorecard.

Avoid radar charts when you have many categories (>8) or when values vary drastically—interpretation becomes difficult.

### Data requirements

* Multiple metrics (axes) arranged radially.
* Each series delivers a value for every metric.
* Normalise scales beforehand to keep axes comparable.

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                                                   |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                                            |
| General → Radar        | Type                    | select     | line, spline, area, areaspline                                                                                       | Sets the rendering of radar chart series (area vs. line).                                                     |
| General → Radar        | Area fill opacity       | number     | —                                                                                                                    | Controls how transparent the filled area is; lower values show more of the background and overlapping series. |
| General → Radar        | Line width              | number     | —                                                                                                                    | Default line thickness for series that inherit from this setting.                                             |
| General → Radar        | Show dots               | boolean    | —                                                                                                                    | Shows markers for the default series configuration (affects multiple chart types).                            |
| General → Radar        | Radius of dots          | number     | —                                                                                                                    | Radius of default series markers when enabled.                                                                |
| General → Radar        | Point start             | number     | —                                                                                                                    | Starting category index or angle for plotting circular data.                                                  |
| General → Radar        | Point interval (deg)    | number     | —                                                                                                                    | Interval between points (in degrees for circular charts or numeric units for linear series).                  |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                                                 |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically.                            |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                                          |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                                                    |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                                            |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                                                    |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                                            |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                                                |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                                             |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                                             |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                                                       |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                                                |
| Axes → X Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                                            |
| Axes → X Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                                           |
| Axes → X Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                                                |
| Axes → X Axis          | Type                    | select     | category, linear                                                                                                     | Sets the horizontal axis scale (category, numeric, logarithmic, or datetime).                                 |
| Axes → X Axis          | Min                     | number     | —                                                                                                                    | Minimum value allowed on this axis or gauge.                                                                  |
| Axes → X Axis          | Max                     | number     | —                                                                                                                    | Maximum value allowed on this axis or gauge.                                                                  |
| Axes → X Axis          | Tick interval           | number     | —                                                                                                                    | Distance between tick marks on the axis (numeric interval).                                                   |
| Axes → X Axis          | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically.                            |
| Axes → X Axis          | Show every n'th label   | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                                                |
| Axes → X Axis          | Rotation of labels      | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                                                     |
| Axes → X Axis          | Tick placement          | select     | on, between                                                                                                          | Whether ticks sit on category positions or between them.                                                      |
| Axes → X Axis          | Point placement         | select     | on, between                                                                                                          | Positions points inside their category slot (on the tick or between ticks).                                   |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                                             |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                                                       |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                                            |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                                                |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                                             |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                                             |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                                                       |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                                                |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                                            |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                                           |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                                                |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                                                |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                                                     |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                                                       |
| Axes → Y Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).                                   |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                                             |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                                                       |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                                          |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                                                    |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                                            |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                                                    |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                                          |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                                                    |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                                            |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                                                    |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                                            |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                                            |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                                                |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                                                |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                                                  |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).                              |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                                           |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                                                  |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                                               |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                                                    |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                                          |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                                                    |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                                            |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                                                    |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                                          |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                                                    |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                                            |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                                                    |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                                                        |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                                          |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                                                    |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                                            |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                                                    |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Waterfall chart

Everything you need to know to create the chart you want.

### Overview

Waterfall charts break down how an initial value increases or decreases through a sequence of contributions, leading to a final result. They’re perfect for explaining “what changed” over time or between scenarios.

### When to use it

* Reconciling financial statements (starting cash → adjustments → ending cash).
* Showing impact of drivers on a KPI (churn, upsell, expansion).
* Explaining project timelines (baseline → scope changes → final date).

Avoid waterfall charts if the order of contributions doesn’t matter or if you lack a clear starting and ending point.

### Data requirements

* Ordered categories representing each step.
* Positive values increase the total; negative values decrease it.

### Style options available

| Group                  | Control                 | Input type | Options                                                                                                              | Description                                                                        |
| ---------------------- | ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Colors                 | Color palette           | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                 |
| General → Waterfall    | Margin between bars     | number     | —                                                                                                                    | Pixel gap between individual bars or columns.                                      |
| General → Waterfall    | Round bars, px          | number     | —                                                                                                                    | Radius applied to round off bar or column corners (in pixels).                     |
| General → Waterfall    | Corners to round        | select     | end, all                                                                                                             | Defines radius for rounding column or bar corners in pixels.                       |
| General → Waterfall    | Border width            | number     | —                                                                                                                    | Thickness of the stroke around the element (bars, candles, gauges).                |
| General → Waterfall    | Connector line width    | number     | —                                                                                                                    | Thickness of the leader lines that link labels to data.                            |
| General → Waterfall    | Connector line color    | color      | —                                                                                                                    | Colour of the leader lines connecting labels to slices or points.                  |
| General → Waterfall    | Up color                | color      | —                                                                                                                    | Fill colour for increasing candlesticks or bars.                                   |
| General → Waterfall    | Show total column       | boolean    | —                                                                                                                    | Adds a final total column to the waterfall chart.                                  |
| General → Waterfall    | Name of total           | text       | —                                                                                                                    | Label text used for the total column in waterfall charts.                          |
| General → Data labels  | Show data labels        | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                      |
| General → Data labels  | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| General → Data labels  | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| General → Data labels  | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| General → Data labels  | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| General → Data labels  | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → X Axis          | Show X Axis             | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                 |
| Axes → X Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → X Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → X Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → X Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → X Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → X Axis          | Allow labels to overlap | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically. |
| Axes → X Axis          | Show every n'th label   | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                     |
| Axes → X Axis          | Rotation of labels      | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                          |
| Axes → X Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → X Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Y Axis          | Show Y Axis             | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                 |
| Axes → Y Axis          | Base line width         | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                     |
| Axes → Y Axis          | Grid line width         | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                  |
| Axes → Y Axis          | Base line color         | color      | —                                                                                                                    | Colour of the axis baseline line.                                                  |
| Axes → Y Axis          | Grid line color         | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                            |
| Axes → Y Axis          | Grid line style         | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                     |
| Axes → Y Axis          | Tick width              | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                 |
| Axes → Y Axis          | Tick length             | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                |
| Axes → Y Axis          | Tick color              | color      | —                                                                                                                    | Colour of the axis tick marks.                                                     |
| Axes → Y Axis          | Labels alignment        | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                     |
| Axes → Y Axis          | X offset                | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                          |
| Axes → Y Axis          | Y offset                | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                            |
| Axes → Y Axis          | Type                    | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).        |
| Axes → Y Axis          | Opposite side           | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                  |
| Axes → Y Axis          | Margin for title        | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                            |
| Axes → Common          | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Common          | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Common          | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Common          | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Axes → Axes titles     | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Axes → Axes titles     | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Axes → Axes titles     | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Axes → Axes titles     | X Axis margin           | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                 |
| Axes → Axes titles     | Y Axis margin           | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                 |
| Legend → Main          | Show legend             | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                     |
| Legend → Main          | Horizontal align        | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                     |
| Legend → Main          | Vertical align          | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                       |
| Legend → Main          | Layout                  | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).   |
| Legend → Additional    | Margin for legend       | number     | —                                                                                                                    | Outer margin around the legend box.                                                |
| Legend → Additional    | Margin top for items    | number     | —                                                                                                                    | Top padding inside the legend between items.                                       |
| Legend → Additional    | Margin bottom for items | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                    |
| Legend → Additional    | Distance between items  | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                         |
| Legend → Style         | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Legend → Style         | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Legend → Style         | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Legend → Style         | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart title    | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart title    | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart title    | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |
| Title → Chart title    | Margin bottom           | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                             |
| Title → Chart subtitle | Font name               | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                               |
| Title → Chart subtitle | Font style              | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                         |
| Title → Chart subtitle | Font size               | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                 |
| Title → Chart subtitle | Font color              | color      | —                                                                                                                    | Colour of the text shown for this element.                                         |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Create Multitype chart

Everything you need to know to create the chart you want.

### Overview

Multitype charts combine different series types (e.g., columns and lines) in one visual. They help compare metrics with different units or storytelling roles within a single frame.

### When to use it

* Pairing a primary measure (columns) with a trend or target line.
* Showing actual vs. cumulative metrics (e.g., revenue bars with running total line).
* Combining bars with scatter points to highlight outliers.

Avoid multi-type charts if you can tell the story with a single chart type—simplicity wins when the message is straightforward.

### Data requirements

* Shared categories across all series.

### Style options available

| Group                   | Control                       | Input type | Options                                                                                                              | Description                                                                           |
| ----------------------- | ----------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Colors                  | Color palette                 | palette    | —                                                                                                                    | Palette applied to series; sets the default colours for the chart.                    |
| General → Line and Area | Line width                    | number     | —                                                                                                                    | Default line thickness for series that inherit from this setting.                     |
| General → Line and Area | Line style                    | select     | Solid, Dash, Dot                                                                                                     | Dash pattern applied to lines.                                                        |
| General → Line and Area | Show dots                     | boolean    | —                                                                                                                    | Shows markers for the default series configuration (affects multiple chart types).    |
| General → Line and Area | Radius of dots                | number     | —                                                                                                                    | Radius of default series markers when enabled.                                        |
| General → Line and Area | Fill opacity (0...1)          | number     | —                                                                                                                    | Opacity of the shared series fill (used by charts that inherit from series defaults). |
| General → Column        | Stacking                      | select     | normal, none                                                                                                         | Stacking mode for the series (normal/percent/none).                                   |
| General → Column        | Margin between bars (0...1)   | number     | —                                                                                                                    | Relative gap between bars inside one category (0 = touching, 1 = wide spacing).       |
| General → Column        | Margin between groups (0...1) | number     | —                                                                                                                    | Relative gap between grouped bar clusters.                                            |
| General → Column        | Round bars, px                | number     | —                                                                                                                    | Radius applied to round off bar or column corners (in pixels).                        |
| General → Column        | Corners to round              | select     | end, all                                                                                                             | Defines radius for rounding column or bar corners in pixels.                          |
| General → Column        | Color each column             | boolean    | —                                                                                                                    | Assigns a unique colour to every column instead of sharing a palette per series.      |
| General → Column        | Margin between stacked bars   | number     | —                                                                                                                    | Gap between stacked series blocks when columns are grouped.                           |
| General → Data labels   | Show data labels              | boolean    | —                                                                                                                    | Shows numeric labels directly on data points.                                         |
| General → Data labels   | Allow labels to overlap       | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically.    |
| General → Data labels   | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                  |
| General → Data labels   | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                            |
| General → Data labels   | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                    |
| General → Data labels   | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                            |
| Axes → X Axis           | Show X Axis                   | boolean    | —                                                                                                                    | Shows or hides the X axis line, ticks, and labels.                                    |
| Axes → X Axis           | Base line width               | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                        |
| Axes → X Axis           | Grid line width               | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                     |
| Axes → X Axis           | Base line color               | color      | —                                                                                                                    | Colour of the axis baseline line.                                                     |
| Axes → X Axis           | Grid line color               | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                               |
| Axes → X Axis           | Grid line style               | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                        |
| Axes → X Axis           | Tick width                    | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                    |
| Axes → X Axis           | Tick length                   | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                   |
| Axes → X Axis           | Tick color                    | color      | —                                                                                                                    | Colour of the axis tick marks.                                                        |
| Axes → X Axis           | Allow labels to overlap       | boolean    | —                                                                                                                    | Allows labels to render even if they collide instead of hiding them automatically.    |
| Axes → X Axis           | Show every n'th label         | number     | —                                                                                                                    | Skips labels so only every nth label is drawn.                                        |
| Axes → X Axis           | Rotation of labels            | number     | —                                                                                                                    | Rotation angle applied to axis or data labels in degrees.                             |
| Axes → X Axis           | Opposite side                 | boolean    | —                                                                                                                    | Positions the axis on the opposite side of the chart (top/right).                     |
| Axes → X Axis           | Margin for title              | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                               |
| Axes → Y Axis           | Show Y Axis                   | boolean    | —                                                                                                                    | Shows or hides the Y axis line, ticks, and labels.                                    |
| Axes → Y Axis           | Base line width               | number     | —                                                                                                                    | Thickness of the axis baseline line in pixels.                                        |
| Axes → Y Axis           | Grid line width               | number     | —                                                                                                                    | Thickness of gridlines in pixels.                                                     |
| Axes → Y Axis           | Base line color               | color      | —                                                                                                                    | Colour of the axis baseline line.                                                     |
| Axes → Y Axis           | Grid line color               | color      | —                                                                                                                    | Colour for gridlines drawn across the chart background.                               |
| Axes → Y Axis           | Grid line style               | select     | Solid, ShortDash, ShortDot, ShortDashDot, ShortDashDotDot, Dot, Dash, LongDash, DashDot, LongDashDot, LongDashDotDot | Line pattern used for gridlines (solid, dashed, dotted, etc.).                        |
| Axes → Y Axis           | Tick width                    | number     | —                                                                                                                    | Thickness of tick marks in pixels.                                                    |
| Axes → Y Axis           | Tick length                   | number     | —                                                                                                                    | Length of the tick marks in pixels.                                                   |
| Axes → Y Axis           | Tick color                    | color      | —                                                                                                                    | Colour of the axis tick marks.                                                        |
| Axes → Y Axis           | Labels alignment              | select     | left, center, right                                                                                                  | Horizontal alignment of axis labels relative to the tick mark.                        |
| Axes → Y Axis           | X offset                      | number     | —                                                                                                                    | Horizontal offset applied to axis labels.                                             |
| Axes → Y Axis           | Y offset                      | number     | —                                                                                                                    | Vertical offset applied to axis labels.                                               |
| Axes → Y Axis           | Type                          | select     | category, linear, logarithmic, datetime                                                                              | Sets the vertical axis scale (category, numeric, logarithmic, or datetime).           |
| Axes → Y Axis           | Margin for title              | number     | —                                                                                                                    | Space between the axis title and the axis labels/ticks.                               |
| Axes → Common           | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                  |
| Axes → Common           | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                            |
| Axes → Common           | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                    |
| Axes → Common           | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                            |
| Axes → Axes titles      | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                  |
| Axes → Axes titles      | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                            |
| Axes → Axes titles      | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                    |
| Axes → Axes titles      | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                            |
| Axes → Axes titles      | X Axis margin                 | number     | —                                                                                                                    | Extra padding around the X axis labels for titles.                                    |
| Axes → Axes titles      | Y Axis margin                 | number     | —                                                                                                                    | Extra padding around the Y axis labels for titles.                                    |
| Legend → Main           | Show legend                   | boolean    | —                                                                                                                    | Shows or hides the legend box.                                                        |
| Legend → Main           | Horizontal align              | select     | left, center, right                                                                                                  | Horizontal alignment for the legend box (left, centre, right).                        |
| Legend → Main           | Vertical align                | select     | top, middle, bottom                                                                                                  | Vertical alignment for the legend box (top, middle, bottom).                          |
| Legend → Main           | Layout                        | select     | horizontal, vertical, proximate                                                                                      | Orientation of the legend items (horizontal row, vertical column, or proximate).      |
| Legend → Additional     | Margin for legend             | number     | —                                                                                                                    | Outer margin around the legend box.                                                   |
| Legend → Additional     | Margin top for items          | number     | —                                                                                                                    | Top padding inside the legend between items.                                          |
| Legend → Additional     | Margin bottom for items       | number     | —                                                                                                                    | Bottom padding inside the legend between items.                                       |
| Legend → Additional     | Distance between items        | number     | —                                                                                                                    | Horizontal spacing between legend entries.                                            |
| Legend → Style          | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                  |
| Legend → Style          | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                            |
| Legend → Style          | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                    |
| Legend → Style          | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                            |
| Title → Chart title     | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                  |
| Title → Chart title     | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                            |
| Title → Chart title     | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                    |
| Title → Chart title     | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                            |
| Title → Chart title     | Margin bottom                 | number     | —                                                                                                                    | Extra space below chart titles or subtitles in pixels.                                |
| Title → Chart subtitle  | Font name                     | text       | —                                                                                                                    | Font family used for titles, labels, or legend text.                                  |
| Title → Chart subtitle  | Font style                    | text       | —                                                                                                                    | Font weight or style (e.g., bold, italic).                                            |
| Title → Chart subtitle  | Font size                     | number     | —                                                                                                                    | Font size in pixels for the selected text element.                                    |
| Title → Chart subtitle  | Font color                    | color      | —                                                                                                                    | Colour of the text shown for this element.                                            |

### Have problems or want to improve this chart type?

Ping us via <hello@chartplugin.com>.


# Critical errors & fixes

When something blocks the plugin from working, you’ll see a red banner at the top of the UI with a clear message. Use this reference to resolve issues quickly.

| Banner message                                | What it means                                               | How to fix it                                                                                                                                         |
| --------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **“License check is unavailable.”**           | The plugin couldn’t reach the license server.               | Check your internet connection, then click **Activate/Manage** in the Status Bar to retry. If the issue persists, contact support with the timestamp. |
| **“Templates service unavailable.”**          | Template storage couldn’t be loaded.                        | Charts still work, but templates won’t sync. Re-enter your license email or try again later.                                                          |
| **“Failed to load data from Google Sheets.”** | Permission, timeout, or structural issue with the sheet.    | Confirm you have access, verify headers, and refetch.                                                                                                 |
| **“Request parameters must be valid JSON.”**  | JSON body or headers are malformed.                         | Validate your JSON in an external tool and paste it again.                                                                                            |
| **“Preview is not ready yet.”**               | The plugin couldn’t find SVG contents during insert/update. | Wait for the preview to render (enable Show preview) before pressing Insert/Update.                                                                   |

### General recovery steps

1. Refresh the plugin UI (close and reopen) if the state seems stuck.
2. For data issues, switch sources temporarily to Random to confirm the rest of the pipeline works.
3. Collect logs: open Figma Console and set `window.__CHART_LOG_LEVEL = "debug"` before reproducing the problem.


# FAQ

Answers to common questions designers ask while working with Chart plugin.

### Can I reuse a chart in multiple files?

Yes. Insert the chart, then copy and paste it into other Figma files. The embedded metadata travels with the frame, so you can still run **Update Chart** later.

### How do I share templates with teammates?

As long as everyone uses the same license email (only for TEAM accounts), templates sync to the cloud. Remind teammates to reopen plugin after new templates are saved.

### Why doesn’t my chart match the brand colours?

Apply or update a template. If you have multiple brand modes, create separate templates (`Brand Light`, `Brand Dark`) and document when to use each.

### Can I export charts as PNG or SVG files?

Yes. After inserting the chart into Figma, use Figma’s export panel to export as PNG/SVG/PDF. The plugin itself inserts vector layers ready for export.

### Does the plugin support dark mode charts?

Absolutely. Create a template with dark backgrounds and light text. Save it as `Dark Mode` and apply it whenever you design dark-themed screens.

### How do I update data without losing styling?

Use **Update Chart** from the relaunch menu. This keeps styles, templates, and metadata intact while refreshing the data source.

### Is there a way to lock chart edits?

Once the chart is inserted, you can lock the Figma frame to prevent accidental edits. For template protection, restrict who has access to manage templates in the plugin.


# Release notes

Welcome to the **Chart Plugin Release notes** page — your hub for all updates, improvements, and new features.

Here you can explore every version of Chart, from the earliest releases to the latest, and see how the plugin has evolved to make data visualization in Figma/Sketch faster, smarter, and more flexible.

Select a version below to see what’s new:

* [Version 3.0](/release-notes/chart-plugin-v3.0-major-update)


# Chart Plugin v3.0 — Major update

We’re excited to release version **3.0**, our biggest update yet!

#### ✨ New Features

* **Dozens of new style options** across all chart types — you can now customize virtually every aspect of your chart’s appearance.
* **Improved API data import** — supports authentication, request parameters, and fetching deeply nested data structures.

#### 💡 UI & UX Improvements

* **My Account** moved to the main screen for easier access.
* Enhanced **performance** and **interface responsiveness**.
* Added **error notifications** and more informative feedback throughout the UI.

#### 🧩 Fixes

* Fixed compatibility issues with **Figma Slides** — the plugin now works seamlessly in presentation mode.

Upgrade to Chart **v3.0** and experience a faster, more flexible, and more powerful way to visualize your data in Figma.


# Chart Plugin v3.1

We’re excited to release version 3.1 — a refinement-packed update that makes the Chart plugin more precise, flexible, and powerful for advanced workflows.

### ✨ New Features

* **Manual hex code editing** — you can now enter color values directly for pixel-perfect control.
* **Linear gradients for Bar & Column charts** — create richer, more expressive visuals right inside Figma.
* **Control X-axis label step & position** — fine-tune dense charts and achieve cleaner layouts.
* **Flexible height for the Manual Table** — adapt the data-entry view to your workflow and screen size.
* **Smart Template creation using document styles** — build templates faster with automatic detection of colors and text styles.

### ⚙️ UI & Performance Improvements

* **Resizable Chart UI is back** — adjust the plugin interface to fit your workspace.
* Improved stability when working with **heavy Figma files in the browser** (memory management and preview rendering optimized).

Upgrade to Chart v3.1 for a smoother, more customizable, and more intelligent chart-building experience in Figma.


# Chart Plugin v4.0 — Major update

We’re excited to ship 4.0 with AI-assisted chart creation and a new place to talk with us.

#### ✨ New Features

* **AI Chart (alpha):** turn a chart screenshot into an editable Chart in Figma. Copy our prompt, get chart.txt from your AI, upload, and instantly preview/create. Edit everything afterwards with our plugin.
* **Discord community:** [we’ve opened a server](https://discord.gg/PHeG3nQADk) to share feedback, request features, and see what’s coming.


# Chart Plugin v4.1

We’re excited to ship **Chart 4.1** with support for **custom chart types** and improvements to how custom charts work inside Figma.

#### ✨ New Features

* **Custom Charts:** Chart now supports custom chart types. Once implemented for your account, they appear in the sidebar as native chart types and work exactly like built-in charts.
* **Full edit workflow:** Custom charts support the complete flow — preview, create, and edit.


# Customer support

Contact us to solve any problem related to the plugin or ask a question.

#### 🐞 Report a bug

If you have any issues, or feedback, just reach out to us in [**Discord**](https://discord.gg/PHeG3nQADk) or via **<hello@chartplugin.com>** — our team is here **every Monday to Friday**.

We usually reply within **1–2 hours** during our active support hours: **00:00–11:00 AM PST**.\
Your message will never go unnoticed — we do our best to respond as quickly and clearly as possible.

#### 💡 Suggest a feature

Got an idea for a new feature or an improvement to the plugin?\
We’d love to hear it! You can share your suggestions (ping us [**Discord**](https://discord.gg/PHeG3nQADk) or via **<hello@chartplugin.com>**) or vote for existing ideas on our public [**Chart Plugin Trello board**](https://trello.com/b/AVh8NlE4/chart-plugin).

Your feedback helps us make Chart better with every release.


# Manual table

The Manual Table Editor lets you paste or type values directly into the plugin when you’re working with compact datasets. It keeps a 100 × 50 grid in sync with the chart preview.

### When to use it

* You have fewer than \~100 rows and want to tweak numbers on the fly.
* You’re exploring scenarios without access to the original spreadsheet.
* You need to adjust imported data after the fact without switching sources.

### Key UI areas

1. **Header row** — first row contains column names. The first column is treated as categories; subsequent columns become series.
2. **Grid body** — double-click to edit a cell, press `Enter` or `Tab` to move around quickly.

### Workflow

1. Select **Table → Manual** from the Data tab.
2. Paste data from your spreadsheet (cmd/ctrl + V) or type values manually.
3. Optionally rename the first row to control legend labels.

### Troubleshooting

| Problem                       | What to check                                                                  |
| ----------------------------- | ------------------------------------------------------------------------------ |
| Numbers disappear after paste | Ensure the source uses plain text or numbers; merged cells can break the grid. |
| Chart skips some rows         | Verify the first column has values—empty labels are excluded.                  |
| Performance slows down        | Reduce rows/columns or switch to CSV/Google Sheets for larger datasets.        |


# Google Sheets

Bring live spreadsheet data into your chart. The plugin fetches the sheet, maps headers to categories and series, and keeps your configuration ready for refreshes.

### Data prep checklist

* First row should contain headers (e.g. `Month`, `Revenue`, `Cost`).
* No merged cells or formulas that return text when numbers are expected.
* If the sheet is private, confirm your browser session has access.

### Import steps

1. **Switch to Table → Google** in the Data tab.
2. Paste the **full Google Sheet URL**.
3. Specify the **Worksheet name** if it’s not the first tab.
4. Select the columns you want to use. The plugin automatically treats the first as categories.

### Common errors

| Error banner                              | Meaning                                   | Fix                                                                    |
| ----------------------------------------- | ----------------------------------------- | ---------------------------------------------------------------------- |
| “Failed to load data from Google Sheets.” | Network, permission, or rate-limit issue. | Check access rights, try again, or duplicate the sheet to reduce load. |
| Preview shows wrong numbers               | Column order changed since last fetch.    | Reopen the column picker and reselect the intended fields.             |

### Tips for designers

* Use a dedicated worksheet for chart data; keep formatting and calculations separate.
* If a stakeholder updates the sheet, remind them not to move the header row or delete columns in use.


# CSV

CSV files are perfect when stakeholders export data from BI tools or spreadsheets. The plugin maps CSV columns to categories and series similarly to Google Sheets but without requiring live access.

### Preparing your CSV

* Use UTF-8 encoding whenever possible.
* Keep the header row (first line) for column names.
* Separate values with commas or semicolons; the plugin auto-detects both.
* Remove blank lines at the bottom to avoid empty categories.

### Import steps

1. Switch to **Table → CSV** in the Data tab.
2. Upload the CSV file.
3. Select which columns to import. First column = categories, others = series.

### Troubleshooting

| Issue                            | Diagnosis                                               | Fix                                              |
| -------------------------------- | ------------------------------------------------------- | ------------------------------------------------ |
| Column headers missing           | File lacks first-row names.                             | Add a header row and re-export.                  |
| Numbers parse as text            | Check decimal separator; select `.` or `,` accordingly. | Adjust delimiter/decimal settings before import. |
| Chart shows extra blank category | Trailing newline in CSV.                                | Trim the file and re-upload.                     |

### Tips

* Store CSV snapshots in your project folder for version control.
* Combine manual tweaks with the Manual Table Editor after import if you need to adjust a few values by hand.


# JSON API or File

Connect to product analytics or dashboard endpoints that expose JSON. The plugin uses a proxy to make requests, map nested arrays, and convert them into chart-ready series.

### When to use it

* You have an HTTP endpoint returning JSON data.
* You need to authenticate with a bearer token or custom headers.
* Your data lives in nested arrays and you want to pick which keys become categories and series.

### Request setup

1. Switch to **Data Source → JSON** and choose the `API` mode.
2. Enter the **URL** and choose the HTTP **Method** (`GET` or `POST`).
3. If authentication is needed:
   * `Bearer` — paste the token; the plugin adds the header.
   * `Custom headers` — paste a JSON object (e.g. `{ "X-API-Key": "123" }`).
4. Optional: add request parameters or body. Provide a JSON object.

### Selecting data

1. Click **Fetch** to send the request through the proxy.
2. After a successful response, pick the array path containing your records (e.g. `<root>`, `data.items`).
3. Choose the **Category field** (x-axis labels) and one or more **Value fields** (series). The preview updates as soon as selections are made.

### Tips

* Test the endpoint in Postman or a browser first to confirm the response shape.
* Avoid extremely large payloads—paginate on the server side if possible.

### Troubleshooting

| Error banner                             | Meaning                                     | Fix                                                                       |
| ---------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------- |
| “Request parameters must be valid JSON.” | Invalid JSON in headers/body.               | Validate with a formatter and try again.                                  |
| “Failed to fetch JSON data.”             | Network error, auth failure, or CORS block. | Check the HTTP status in the console/log banner and confirm credentials.  |
| Preview array list is empty              | Response doesn’t contain arrays of objects. | Check the array path and ensure the endpoint returns an array of records. |

### Security note

The proxy forwards your request payload and headers to `https://chart-plugin.com/proxy`. Avoid sending highly sensitive data or credentials unless you trust the endpoint owner.


# With manual styles

Chart is highly customizable, read how to set up your own style for each chart.

The Style tab gives you full control over how your chart looks. It’s broken into logical panels so you can move from broad styling to fine details.

If you need something beyond what’s available here — pixel-perfect, 1:1 with your design — we’ve got you covered. With **Custom charts**, our team can add any chart exactly as in your mockups to your Chart account. Just **send us your Figma file at <hello@chartplugin.com>** and we’ll take care of the rest.

<figure><img src="/files/Xc16AcYGJdrdALpBkv89" alt=""><figcaption></figcaption></figure>

### Layout

1. **Palette & series colours** — set individual series colours, gradients, and opacity.
2. **Typography** — adjust font family, weight, size, and colour for titles, labels, and tooltips.
3. **Grid** — change gridline styles.
4. **Data label controls** — toggle labels, set formats.

### Working with series colours

* Click a swatch to open the colour picker; use HEX.
* Reorder series to match your legend order.

### Typography tips

* Match your product’s type ramp by using your primary brand font.
* Use upper/lowercase intentionally—chart labels inherit exactly what you type.
* Set subtitles to a smaller point size to create hierarchy.

### Grids

* Use subtle gridlines (light grey or low opacity) to avoid visual noise.
* Add padding via the Settings tab to create breathing room for titles.

### Data labels

* Enable labels sparingly—too many labels can clutter the chart.
* Use number formatters (Settings) to keep labels consistent (e.g. $1.2K, 12.3%).
* For pie charts, combine labels with contrasting colours to maintain readability.


# Using a Template

Template is the best option to style every part of chart and use it forever.

Templates capture the entire Style tab configuration—colours, typography, even per-chart-type tweaks. They make it easy to share design language across your team. One template contains styles for all chart types.

### Templates

Access the Templates via the plugin menu and manage it:

* **List view** — shows every template.
* **Reorder** — click Make default; the first template becomes the default.
* **Delete** — removes a template. You’ll be asked to confirm.
* **Copy** — duplicate a template to experiment safely.

### Collaboration tips

* Use consistent naming conventions (e.g. `Dept - Use Case`).

### Troubleshooting

| Issue               | Fix                                                                                                   |
| ------------------- | ----------------------------------------------------------------------------------------------------- |
| Template list empty | Sign in or re-enter your license key in the Create chart UI.                                          |
| Cannot save         | Ensure your license email is set and template service is reachable. Check the Critical Errors banner. |


# Custom charts

Chart as most chart plugins help you generate standard charts. But many teams need something more specific: charts that match internal brand guidelines, product UI, presentation styles, research report layouts, or custom data visualization standards.

With **Custom Charts for Teams**, we can turn those designs into reusable chart types inside Chart.

That means your team can generate charts in Figma that match your company’s required style — instead of rebuilding them manually every time.

👉 Send your chart mockups to **<hello@chartplugin.com>** and get it inside Chart in 1 day!

### Just a few examples

Custom Charts let us create almost any non-standard chart type, as well as standard charts with advanced styling beyond what is available in the Style tab of the basic plugin.

<figure><img src="/files/tRwrvf4NN05DJkh6lwiY" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/2gbLKOmrSVckeJGZuGGg" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/qC5s1NeJ4n8mNNBvw1vt" alt=""><figcaption></figcaption></figure>

### What this means in practice

If you already have chart mockups, design references, or examples from your reports, dashboards, or presentations, we can use them as a basis for implementation.

We can recreate:

* custom chart types
* brand-specific styling
* non-standard visual compositions
* unique label treatments
* custom legends, annotations, and decorative elements
* chart variants that standard plugins usually cannot generate well

The result is a reusable chart setup inside Chart that your team can use directly in Figma.

### From mockup to reusable chart type

The usual workflow is simple:

1. **Share your references**. Send us your Figma files, mockups, screenshots, or examples of the chart styles you need.
2. **We review the requirements**. We look at the structure, styling, edge cases, and what should be reusable for your team.
3. **We implement the custom chart**. We build the chart type or styling into Chart.
4. **Your team uses it in Figma**. Once ready, your team can generate those charts directly in Figma instead of recreating them manually.


# Canvas, Axes, and Formatting

Fine-tune how your chart appears by adjusting the canvas size, margins, axis titles, and number/date formatting. These settings are especially important when you’re preparing production-ready visuals.

### Canvas & margins

* **Canvas width/height** — matches the size of the SVG inserted into Figma. Align these dimensions with your layout grid.
* **Margins** — add breathing room around the chart so titles and labels aren’t clipped. Increase margins when enabling legends or long axis labels.

### Titles and subtitles

* Provide clear titles and optional subtitles to describe the chart at a glance.
* Keep them concise; use the same tone as the rest of your presentation.
* Pair with the Style tab’s typography settings for consistent branding.

### Axes

* **X-axis title** — add context (e.g., “Month” or “Sprint”).
* **Y-axis primary/secondary** — label metrics (e.g., “Revenue ($K)”). Secondary axis is useful for multi-metric charts.
* **Min/Max** — override auto-scaling if you need consistent ranges across charts.
* **Tick interval** — define step sizes for the axis. Leave blank to auto-calculate.

### Number formatting

Located under **Simple Formatter**:

* **Prefix/Suffix** — add currency symbols (`$`, `€`) or units (`%`).
* **Grouping & thousands separator** — choose space, comma, or period.
* **Decimals** — control precision.
* **Abbreviate** — toggle compact notation (e.g., “1.2K”).

### Date formatting

* If your x-axis uses dates, you can control it's format (e.g., `%Y-%m-%d`).


# Use Chart with Components and Auto layout in Figma

If you want to build scalable DataViz library in Figma, you need to know how to combine full power of Chart with great tools that available in Figma. Watch the tutorial to save days of experiments with settings in Figma. Contact us via <hello@chartplugin.com>, if you need our assistance or consultancy.

{% embed url="<https://www.loom.com/share/586a8f98e5cc40879e841288462a0ef7?sid=33978f05-7ae4-44e1-973f-1a7dd92c2a97>" %}


# How to resize chart

Resize your charts to redraw them with better-than-smart logic with one click.

Resizing a chart is a common use case. Just use Update option once you've resized your chart manually: resize chart as you want, then select it and go to `Plugins → Chart → Update chart` and wait for ✨ the magic.

Check this short video to see how it could be done:

{% embed url="<https://www.loom.com/share/ace971e68fa5444f9a0b75bffe300c47?sid=e7974b73-0380-4351-8115-4f9a9dc5b207>" %}


# How to update chart with data from Google Sheet or API

Connecting Chart to Google Sheets or an API keeps your chart updated with real data.

You've created chart with data from Google Sheet or API and now wondering how to reflect data updates on your chart? That is easy as 1-2-3, just use Update option in Chart. Select chart, that you've created, then go to `Plugins → Chart → Update chart` and wait for ✨ the magic.

Let's see how Chart could help you to work with dynamic data:

{% embed url="<https://www.loom.com/share/118446643046449290dced4e4c329fa1?sid=38e3e2b1-5588-446d-8821-eff9642ae6e7>" %}


# How to upgrade to Pro or Team version

Pay just $10/year to unlock all charts and save hours of boring work.

To unlock all chart types or use Chart for a team you need to upgrade. If you are an individual contributor and one license is enough for you — select the Pro tier. If you want to use Chart in your team, just select Team account. Team account has an unlimited number of users for a fixed price.

### Follow these steps to update

1. Go to [the subscription page](https://chartplugin.com/subscribe.html)
2. Select Pro or Team tier and click Subscribe
3. Enter email — we will send you instructions and License key
4. Select payment option
5. When you are done just [Activate subscription in Chart](/how-to-activate-your-subscription)

🎉 Congratulations, you are done!


# Refund Policy

That is easy to unsubscribe or get your money back if you are not satisfied with Chart.

You are paid for Chart but have problems or just want to stop subscription? 😞 We are really sorry. But you can always ask us to stop subscription or get for a refund.&#x20;

### Follow these steps to stop subscription or get a refund

1. You want:
   1. To unsubscribe: at any time
   2. To get a refund: you are used Chart less than a week or you get an unexpected recurring charge
2. Ping us via <hello@chartplugin.com>
3. We will stop your subscription or do a refund

That is all, easy and fast. You are in good company! 😊


# Terms of Service

Legal information about Chart plugin

Chart plugin is a product of Pavel Kuligin ('us', 'we', or 'our') for Sketch.app, Adobe XD.app, Figma.app.

By purchasing and using our software, you are agreeing to be bound by these terms of service, all applicable laws and regulations, and agree that you are responsible for compliance with any applicable local laws. If you do not agree with any of these terms, you are prohibited from using or accessing Chart plugin. The materials contained in Chart plugin are protected by applicable copyright law.

### License

1\. Permission is granted to download and install Chart plugin within Sketch, Adobe XD, or Figma.

Under this license you may not:

* modify or copy the plugin source code
* attempt to decompile or reverse engineer any software contained in Chart plugin

2\. Your use of Chart will be reviewed and/or removed if you violate any of these restrictions.

### Purchasing Fee

Our pricing plans are simple and transparent that will allow you to use Chart plugin within any software Chart is available. Currently in Sketch, Adobe XD, and Figma. These plans (Free, Pro, and Team) can be found on our [Pricing page](https://chartplugin.com/pricing.html).

We may modify the purchase fee at any time, but it will affect only the new subscriptions.

A valid payment method is required to process the payment for your Purchase. We may add or remove the support for certain payment methods at our discretion.

We reserve the right to refuse or cancel your order if fraud or an unauthorised or illegal transaction is suspected. We will not be held responsible or liable for any failure for the purchase to complete, or any resulting loss or damages to you.

If you have any questions about these Terms, please contact us via <hello@chartplugin.com>.


# Privacy Policy

Your privacy is important to me. Chart collects only anonymized data about which type of chart each user created and when. This data helps me to provide the best customer service and define the roadmap.

I don’t share any personally identifying information publicly or with third parties, except when required by law. All data is securely stored in AWS.

Your continued use of the plugin will be regarded as acceptance of practices around privacy. If you have any questions about how I handle user data, feel free to contact me via <hello@chartplugin.com>.&#x20;

*This policy is effective as of 21 May 2021.*


