# Migration guide

We recently released our overhauled chart cells! They provide you with much more power and flexibility to create and customize charts without writing any code. If you had existing charts in your workbook, from now on referred to as *legacy charts*, you can automatically convert them to our new experience.

## Converting existing charts

You will see a new button in the legacy chart cell that allows you to convert it to the new system. Clicking it will automatically convert your chart. Alternatively, a workbook that contains legacy charts will also have a banner at the top of the page, which allows you to convert all legacy charts at once. 

**Note**: This is only possible if you have 5 or less legacy charts in your workbook. Converting more charts at once could result in performance issues and possibly crash the page.

Most chart configurations should convert seamlessly. However, it may be possible that something is not completely compatible. See the known limitations below.

## Known limitations

* Unsupported aggregate functions
  * Median
    * If used, we will automatically use `average` instead. You can get around this by manually aggregating beforehand.
  * Distinct
    * If used, we will automatically use `count` instead. You can get around this by manually aggregating beforehand.
* Sorting options
  * Sorting is not natively supported. You may have to sort your data beforehand.

## Reporting issues

If you are unable to convert your legacy chart, you can report an issue by clicking on "Give feedback" in the left side panel, then select "Report issue". Please provide as much information as possible, such as the chart type and which data types were used on which axis.

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://datalab-docs.datacamp.com/work/chart-cell/migration-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.