> For the complete documentation index, see [llms.txt](https://docs.pptxbuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pptxbuilder.com/api-reference/json-pptx/request-data/chart-settings/chart-view-settings.md).

# Chart View Settings

This page describes how to set the view settings for a specific chart.

You can provide specific settings for each chart on your presentation. These settings can include `chart-type`, `font-family,` `sorting`, `placeholder`. Check below for a full spec of the attributes available.

#### Chart view settings

| Name                               |      Type      | Required |                                                                                   Description                                                                                  | Values                                                                                                                                                                                                                                                                                                                                        |
| ---------------------------------- | :------------: | :------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| chart\_type                        |     String     |   true   |                                                                     This attribute defines the chart\_type.                                                                    | <p></p><p><code>Check the chart types section.</code></p>                                                                                                                                                                                                                                                                                     |
| placeholder\_index                 | Integer/String |   true   | This attribute defines in which placeholder the chart should be mounted. Should be unique. You can also pass the name of the placeholder instead as it appears in power point. | `0-99`                                                                                                                                                                                                                                                                                                                                        |
| show\_legend                       |     String     |   false  |                                                            Controls the position and visibility of the chart legend.                                                           | <p></p><p><code>\[</code></p><p><code>"none",</code></p><p><code>"bottom",</code></p><p><code>"left",</code></p><p><code>"right",</code></p><p><code>"top"</code></p><p><code>]</code></p>                                                                                                                                                    |
| show\_legend\_font\_family         |     String     |   false  |                                                              Defines the `font-family` used for the chart legend.                                                              | `Check the fonts section`                                                                                                                                                                                                                                                                                                                     |
| show\_data\_labels                 |     String     |   false  |                                                      This attribute defines the position of the data labels in the chart.                                                      | `Check the data labels section.`                                                                                                                                                                                                                                                                                                              |
| show\_value\_axis                  |     String     |   false  |                                                              This attribute controls the position of the `y` axis.                                                             | <p><code>\[</code></p><p><code>"none",</code></p><p><code>"default",</code></p><p><code>"opposite"</code></p><p><code>]</code></p>                                                                                                                                                                                                            |
| show\_sort                         |     String     |   false  |                                                         This attribute controls the sorting of the values on the chart.                                                        | <p><code>\[</code></p><p><code>"none",</code></p><p><code>"descending",</code></p><p><code>"ascending"</code></p><p><code>]</code></p>                                                                                                                                                                                                        |
| sorting\_value                     |     String     |   false  |                                                                  This attribute controls the sorting by value.                                                                 | Cross break inner column name. If provided, and `show_sort` descending/ascending, then data will be sorted by it                                                                                                                                                                                                                              |
| show\_category\_axis\_font\_family |     String     |   false  |                                                           This attribute controls the `font-family` for the `x` axis.                                                          | `Check the font section.`                                                                                                                                                                                                                                                                                                                     |
| show\_value\_axis\_font\_family    |     String     |   false  |                                                           This attribute controls the `font-family` for the `y` axis.                                                          | `Check the font section.`                                                                                                                                                                                                                                                                                                                     |
| show\_data\_label\_font\_family    |     String     |   false  |                                                          This attribute controls the `font-family` for the data label.                                                         | `Check the font section.`                                                                                                                                                                                                                                                                                                                     |
| series\_marker\_style              |     String     |   false  |                                                   This attribute controls the marker displayed when hovering the data points.                                                  | <p></p><p><code>\[</code></p><p><code>"automatic",</code></p><p><code>"circle",</code></p><p><code>"dash",</code></p><p><code>"diamond",</code></p><p><code>"dot",</code></p><p><code>"none",</code></p><p><code>"picture",</code></p><p><code>"plus",</code></p><p><code>"square",</code></p><p><code>"star"</code></p><p><code>]</code></p> |
| series\_by                         |     String     |   false  |                                                               This attribute controls how data will be presented.                                                              | `["columns", "rows"]`                                                                                                                                                                                                                                                                                                                         |
| series\_line\_color                |     String     |   false  |                                                                          The main color of the series.                                                                         | `RGB`                                                                                                                                                                                                                                                                                                                                         |
| show\_data\_label\_font\_color     |     String     |   false  |                                                                            Color of the data label.                                                                            | `RGB`                                                                                                                                                                                                                                                                                                                                         |
| show\_legend\_font\_color          |     String     |   false  |                                                                                Legend font color                                                                               | `RGB`                                                                                                                                                                                                                                                                                                                                         |
| show\_value\_axis\_font\_color     |     String     |   false  |                                                                             Value Axis font color.                                                                             | `RGB`                                                                                                                                                                                                                                                                                                                                         |
| vaxis\_tick\_label\_line\_color    |     String     |   false  |                                                                           Value Axis tick line color.                                                                          | `RGB`                                                                                                                                                                                                                                                                                                                                         |
| show\_category\_axis\_font\_color  |     String     |   false  |                                                                             Column axis font color.                                                                            | `RGB`                                                                                                                                                                                                                                                                                                                                         |
| caxis\_tick\_label\_line\_color    |     String     |   false  |                                                                          Column Axis tick line color.                                                                          | `RGB`                                                                                                                                                                                                                                                                                                                                         |
| show\_data\_label\_font\_size      |     Integer    |   false  |                                                                              Data Label font size.                                                                             | `From 1 to x`                                                                                                                                                                                                                                                                                                                                 |
| show\_value\_axis\_font\_size      |     Integer    |   false  |                                                                              Value axis font size.                                                                             | `From 1 to x`                                                                                                                                                                                                                                                                                                                                 |
| show\_category\_axis\_font\_size   |     Integer    |   false  |                                                                             Column axis font size.                                                                             | `From 1 to x`                                                                                                                                                                                                                                                                                                                                 |
| caxis\_tick\_label\_line\_width    |     Integer    |   false  |                                                                          Column Axis tick line width.                                                                          | `From 0 to x`                                                                                                                                                                                                                                                                                                                                 |
| series\_line\_width                |     Integer    |   false  |                                                                               Series line width.                                                                               | `From 0 to x`                                                                                                                                                                                                                                                                                                                                 |
| show\_legend\_font\_size           |     Integer    |   false  |                                                                                Legend font size.                                                                               | `From 0 to x`                                                                                                                                                                                                                                                                                                                                 |
| max\_axis\_scale                   |     Integer    |   false  |                                                                             Maximum value for axis.                                                                            | `From 0 to x`                                                                                                                                                                                                                                                                                                                                 |
| min\_axis\_scale                   |     Integer    |   false  |                                                                             Minimum value for axis.                                                                            | `From 0 to x`                                                                                                                                                                                                                                                                                                                                 |
| decimal\_places                    |     Integer    |   false  |                                                                           Data Label decimal places.                                                                           | `From 0 to x`                                                                                                                                                                                                                                                                                                                                 |
| plot\_gap\_width                   |     Integer    |   false  |                                                                       Defines width of gap in the chart.                                                                       | `From 0 to 500`                                                                                                                                                                                                                                                                                                                               |
| plot\_overlap                      |     Integer    |   false  |                                                                           Data Labels overlap offset.                                                                          | `From 0 to 500`                                                                                                                                                                                                                                                                                                                               |
| legend\_in\_layout                 |     Boolean    |   false  |                                                                           Controls legend visibility.                                                                          | `[true , false]`                                                                                                                                                                                                                                                                                                                              |
| series\_smooth\_line               |     Boolean    |   false  |                                                                           Controls line anti-aliasing                                                                          | `[true , false]`                                                                                                                                                                                                                                                                                                                              |
| hide\_percentage                   |     Boolean    |   false  |                                                                              Hide percentage sign.                                                                             | `[true , false]`                                                                                                                                                                                                                                                                                                                              |
| show\_legend\_font\_bold           |     Boolean    |   false  |                                                                               Legend font weight.                                                                              | `[true , false]`                                                                                                                                                                                                                                                                                                                              |
| show\_horizontal\_gridlines        |     Boolean    |   false  |                                                                        Show chart horizontal grid lines.                                                                       | `[true , false]`                                                                                                                                                                                                                                                                                                                              |
| show\_vertical\_gridlines          |     Boolean    |   false  |                                                                         Show chart vertical grid lines.                                                                        | `[true , false]`                                                                                                                                                                                                                                                                                                                              |
| show\_category\_axis\_font\_bold   |     Boolean    |   false  |                                                                           Category axis font weight.                                                                           | `[true , false]`                                                                                                                                                                                                                                                                                                                              |
| show\_value\_axis\_font\_bold      |     Boolean    |   false  |                                                                             Value axis font weight.                                                                            | `[true , false]`                                                                                                                                                                                                                                                                                                                              |
| show\_data\_label\_font\_bold      |     Boolean    |   false  |                                                                            Data labels font weight.                                                                            | `[true , false]`                                                                                                                                                                                                                                                                                                                              |

#### Example in `JSON`

```javascript
{
  "view_settings": {
    "chart_type": "bar",
    "hide_percentage": true,
    "placeholder_index": 0,
    "show_legend": "bottom",
    "show_legend_font_family": "arial_narrow",
    "show_legend_font_size": 11,
    "show_legend_font_bold": true,
    "show_legend_font_color": "rgb(89,89,89)",
    "show_data_labels": "inside_end",
    "show_data_label_font_family": "arial_narrow",
    "show_data_label_font_size": 11,
    "show_data_label_font_bold": true,
    "show_data_label_font_color": "rgb(255,255,255)",
    "show_horizontal_gridlines": false,
    "show_vertical_gridlines": true,
    "show_value_axis": "none",
    "show_value_axis_font_family": "arial_narrow",
    "show_value_axis_font_size": 10,
    "show_value_axis_font_bold": true,
    "show_value_axis_font_color": "rgb(63,63,63)",
    "show_category_axis_font_family": "arial_narrow",
    "show_category_axis_font_size": 11,
    "show_category_axis_font_bold": true,
    "show_category_axis_font_color": "rgb(63,63,63)",
    "show_sort": "none",
    "sorting_value": "no-sorting",
    "max_axis_scale": 100,
    "min_axis_scale": 0,
    "decimal_places": 0,
    "caxis_tick_label_line_color": "rgb(143,143,143)",
    "caxis_tick_label_line_width": 1,
    "legend_in_layout": false,
    "plot_gap_width": 50,
    "plot_overlap": 0,
    "vaxis_tick_label_line_color": "rgb(143,143,143)",
    "show_chart_title": false,
    "chart_title_font_bold": true,
    "chart_title_font_size": 12,
    "chart_title_font_color": "rgb(123,123,123)",
    "chart_title_font_family": "arial_narrow"
  }
}
```
