# Workflow canvas

This is the area of the interface where you will be adding the different components and data sources that are required to run your analysis, and connecting them in order to define each step of the workflow in order of execution.

In this central panel you will always find the main diagram of your workflow, with all its components and data sources connected according to what you have established.

### Annotations

In the workflow canvas you have the possibility to add visual assets and annotations to provide explanations on your workflow.

You can do it by clicking on the corresponding icon in the toolbar and drag on the canvas. This will help you make very complex workflows more understandable.

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

The notes support [Markdown syntax](https://www.markdownguide.org/basic-syntax/), allowing to add different levels of headers, text formatting, code blocks, in line monospace code, bulleted and ordered lists, links, images, etc.

### Import a file to your workflow

{% hint style="warning" %}
This feature has been deprecated in favor of the [Import from URL](/carto-user-manual/workflows/components/input-output.md#import-from-url) component.\
Take a look at the announcement in our [What's new](/whats-new/q2-2024.md#improved-data-importing-capabilities-in-workflows) section
{% endhint %}

On the toolbar on top of the canvas you will find the *Import file into workflow* button<img src="/files/CWcbsBWQc901TWjKJVNB" alt="" data-size="line">.

Clicking this button will let you select a location in the canvas to place a datasource. After that, select a local file from your computer or specify a URL that will be imported as a data node in your workflow.

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

### Automatic description of a workflow

{% hint style="info" %}
This feature is in public beta, available on demand. Please [contact us](mailto:support@carto.com) if you wish to have it enabled in your account.
{% endhint %}

On the toolbar on top of the canvas you will find the *Generate workflow description* button<img src="/files/kDI1g2nIDVUilPqJjZP6" alt="" data-size="line">.

Clicking this button will let you select a location in the canvas that will contain an automatic description of the workflow.

This description is obtained using **Generative AI** on the workflow's SQL code.

### Rename a node

Double click on a node's name to add a custom name to it. By using more descriptive names, your workflow will be much easier to understand.


---

# 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://docs.carto.com/carto-user-manual/workflows/workflow-canvas.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.