> Markdown version of [Charts 3 to Charts 4 Migration Guide](https://vaadin.com/docs/v8/charts/java-api/charts-migration-vaadin8). Section index: [llms.txt](https://vaadin.com/docs/v8/charts/llms.txt)

# <a id="charts4.migration"></a>Charts 3 to Charts 4 Migration Guide

## <a id="charts4.migration.introduction"></a>Introduction

Charts 4 is using Vaadin Framework 8. Before migrating from Charts 3 to Charts 4, you need to migrate your application to Vaadin 8, see Vaadin Framework 8 migration guide.

## <a id="charts4.migration.changes"></a>Changes in Charts 4

Most of Vaadin Charts 3 API is compatible with Vaadin Charts 4.x. There are two main changes:

- Methods that use Date were deprecated, use Instant instead.

- ContainerDataSeries is deprecated, use DataProviderSeries instead, see ["instructions"](https://vaadin.com/docs/v8/charts/java-api/charts-data.md#charts.data.dataproviderseries).

## <a id="charts4.migration.using.compatibility"></a>Using Vaadin Charts compatibility package

During migration from Charts 3 to Charts 4 you may want to use ContainerDataSeries. To do that, add a dependency to the vaadin-charts-compatibility package:

```
<dependency>
    <groupId>com.vaadin</groupId>
    <artifactId>vaadin-charts-compatibility</artifactId>
    <version>4.0.5</version>
</dependency>
```

Afterwards, change the import statement for ContainerDataSeries to:

```java
import com.vaadin.v7.addon.charts.model.ContainerDataSeries;
```