# ChartingOptions

Canonical page: https://www.adaptabletools.com/docs/reference/chartingoptions

How charts are saved and where they open.

AG Grid chart definitions the user saves are stored in Charting state. These options decide whether that happens automatically, and which element a chart is drawn into.

```ts title="TypeScript"
export interface ChartingOptions 
```

## Properties

| Property | Type | Description | Default |
| --- | --- | --- | --- |
| [agGridContainerName](https://www.adaptabletools.com/docs/reference/chartingoptions.md#aggridcontainername) | `string` | Name shown for AG Grid&#39;s own chart window in the container list. | &#39;AG Grid Window&#39; |
| [chartContainers](https://www.adaptabletools.com/docs/reference/chartingoptions.md#chartcontainers) | [`ChartContainer`](https://www.adaptabletools.com/docs/reference/chartcontainer.md)`[]` | Elements a saved chart can be drawn into, offered by name when the user opens a chart.<br/><br/>Omit this to open charts only in AG Grid&#39;s own window. |   |
| [externalChartingOptions](https://www.adaptabletools.com/docs/reference/chartingoptions.md#externalchartingoptions) | [`ExternalChartingOptions`](https://www.adaptabletools.com/docs/reference/externalchartingoptions.md) | Show, hide, delete and preview for charts that are not AG Grid charts.<br/><br/>Required when the chart is drawn by the application. AdapTable calls these instead of opening an AG Grid chart. |  |
| [restoreChartsOnReady](https://www.adaptabletools.com/docs/reference/chartingoptions.md#restorechartsonready) | `boolean \| 'all' \| string[]` | Opens persisted AG Grid charts when AdapTable is ready.<br/>- `true` or `'all'`: all charts in `Charting.ChartDefinitions`<br/>- `string[]`: chart names to open (matches each definition&#39;s `Name` property) | undefined (no charts opened automatically) |
| [saveChartBehaviour](https://www.adaptabletools.com/docs/reference/chartingoptions.md#savechartbehaviour) | [`SaveChartBehaviour`](https://www.adaptabletools.com/docs/reference/savechartbehaviour.md) | Behaviour for saving Charts: auto, manual (via popup) or none | &#39;none&#39; |

## Property Details

### agGridContainerName

Name shown for AG Grid&#39;s own chart window in the container list.

```ts title="TypeScript"
agGridContainerName?: string;
```

###### Default Value

&#39;AG Grid Window&#39;

###### Property Value

`string`

### chartContainers

Elements a saved chart can be drawn into, offered by name when the user opens a chart.

Omit this to open charts only in AG Grid&#39;s own window.

```ts title="TypeScript"
chartContainers?: ChartContainer[];
```

###### Property Value

[`ChartContainer`](https://www.adaptabletools.com/docs/reference/chartcontainer.md)`[]`

### externalChartingOptions

Show, hide, delete and preview for charts that are not AG Grid charts.

Required when the chart is drawn by the application. AdapTable calls these instead of opening an AG Grid chart.

```ts title="TypeScript"
externalChartingOptions?: ExternalChartingOptions;
```

###### Default Value

###### Property Value

[`ExternalChartingOptions`](https://www.adaptabletools.com/docs/reference/externalchartingoptions.md)

### restoreChartsOnReady

Opens persisted AG Grid charts when AdapTable is ready.
- `true` or `'all'`: all charts in `Charting.ChartDefinitions`
- `string[]`: chart names to open (matches each definition&#39;s `Name` property)

```ts title="TypeScript"
restoreChartsOnReady?: boolean | 'all' | string[];
```

###### Default Value

undefined (no charts opened automatically)

###### Property Value

`boolean | 'all' | string[]`

### saveChartBehaviour

Behaviour for saving Charts: auto, manual (via popup) or none

```ts title="TypeScript"
saveChartBehaviour?: SaveChartBehaviour;
```

###### Default Value

&#39;none&#39;

###### Property Value

[`SaveChartBehaviour`](https://www.adaptabletools.com/docs/reference/savechartbehaviour.md)
