> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Canvas

> Create and use canvas to analyze and investigate industrial data visually.

<a id="create-canvas" />

## Create a canvas

<Steps>
  <Step title="Navigate to Canvas">
    Navigate to <span class="ui-element">Flows</span> > <span class="ui-element">Canvas</span>.
  </Step>

  <Step title="Create a new canvas">
    Select <span class="ui-element">+ Create canvas</span> to start a new canvas.

    <Frame>
      <img class="illustration" src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/flows/canvas_v1.svg" alt="Canvas" />
    </Frame>

    ➀ **Toolbar** — hover over each tool to see a description.

    ➁ **Settings** — select canvas **settings**, add or remove **labels**, **save as PDF**, **lock**, or **duplicate** a canvas.

    ➂ **Menubar** — select an item on the canvas to show **relevant options** for the item, for example, <Icon icon="sparkles" /> **[Explore with AI](/cdf/flows_workspace/flows_workspace#ai-document-analysis)**.

    ➃ **Agents** — open an **AI agent** to work with the canvas.

    ➄ <span class="ui-element">Add data</span> — find and **select data** to add to the canvas. You can also **drag and drop** local files and images directly to the canvas.
  </Step>
</Steps>

<a id="use-agent" />

## Use an agent to find data

<Frame>
  <img class="illustration" src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/flows/Atlas_canvas_v7.svg" alt="Agent in canvas" />
</Frame>

➀ **New session** — start a new conversation with an agent.

➁ **Select locations** — see your current location. Select locations to choose which data the agent can access.

➂ **Add to Canvas** — add the selected data to the canvas.

➃ **Select agent** — select the agent you want to start a conversation with.

<Info>
  To interact with an agent, you need these [capabilities](/cdf/access/guides/capabilities#atlas-ai).

  Learn more about [Atlas AI](/cdf/atlas_ai/concepts/index).
</Info>

<a id="diagram-options" />

## Engineering diagrams

Add engineering diagrams and related data to a canvas.

<Frame>
  <img class="illustration" src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/flows/canvas_engineering_diagram_v1.svg" alt="Canvas engineer diagram" />
</Frame>

➀ **Add related data** — click a purple or orange link and the plus sign (+) to add related data, such as engineering diagrams, files, and time series.

➁ **View live time series data** — pin a time series to the canvas, set threshold values, and use colors to visualize any breaches.

<a id="navigate" />

## Navigate

To navigate on the canvas:

* To **pan**, use the <kbd>Spacebar</kbd> and the mouse, or use two or more fingers on a touchpad.

* To **move** items, select and drag.

* To **zoom**, use the mouse scroll wheel, or pinch and stretch on a touchpad.

<a id="work-with-pdf-files" />

## Work with PDF files

When you add a PDF file to a canvas, you can view it directly, extract individual pages for comparison, and download the canvas or specific pages as a PDF.

### Extract pages

Extracting pages lets you view multiple pages side by side for comparison or analysis.

<Steps>
  <Step title="Select a file">
    Select a file and, on the toolbar, select **Extract pages** <Icon icon="file-plus" />.
  </Step>

  <Step title="Select pages">
    Select all pages, specific pages, or a range of pages to place them on the canvas.

    Extract pages doesn't create a new file. Each extracted page is a view of the original file focused on a specific page. You can use the page controls to navigate to other pages from any extracted view.
  </Step>
</Steps>

For example, if you extract pages 3-6 from a 10-page PDF, you get 4 additional views of the original file, each focused on a specific page from 3 to 6. If you extract all 10 pages, you get 10 additional views next to the original file.

### Download files

**Download a canvas**

Use **Download as PDF** to save the canvas and its contents as a PDF file. Select the canvas name > **Download as PDF**, select the containers and files to include, and select **Download**.

<Note>
  By default, all containers and files on the canvas are selected. Clear the checkboxes for any items you don't want to include. You can also reorder the pages before downloading.
</Note>

**Download a file**

Download an individual file directly from the toolbar. Select the file and then select **Find related data** <Icon icon="panel-left" /> > <Icon icon="arrow-down-to-line" /> **Download**.

<Tip>
  **Download specific pages from a PDF**

  If you only need certain pages from a PDF file, select the canvas name > **Download as PDF**, select the checkbox next to the file, and select **Multiple pages**. Switch to **Selection**, specify the pages you need, and select **Download**.
</Tip>

<a id="supported-file-formats" />

## Supported file formats

Drag and drop these files on to a canvas.

<AccordionGroup>
  <Accordion title="Supported file formats">
    | MIME type                                                                   | Extensions      | Name                                                |
    | :-------------------------------------------------------------------------- | :-------------- | :-------------------------------------------------- |
    | `application/json`                                                          | `.json`         | JavaScript Object Notation                          |
    | `application/msword`                                                        | `.doc`          | Microsoft Word document (older format)              |
    | `application/pdf`                                                           | `.pdf`          | Portable Document Format                            |
    | `application/rtf`                                                           | `.rtf`          | Rich Text Format                                    |
    | `application/vnd.apple.numbers`                                             | `.numbers`      | Apple Numbers spreadsheet                           |
    | `application/vnd.ms-excel`                                                  | `.xls`          | Microsoft Excel spreadsheet (older format)          |
    | `application/vnd.ms-excel.sheet.binary.macroEnabled.12`                     | `.xlsb`         | Microsoft Excel Binary Workbook                     |
    | `application/vnd.ms-excel.sheet.macroEnabled.12`                            | `.xlsm`         | Microsoft Excel Macro-Enabled Workbook              |
    | `application/vnd.ms-excel.template.macroEnabled.12`                         | `.xltm`         | Microsoft Excel Macro-Enabled Template              |
    | `application/vnd.ms-powerpoint`                                             | `.ppt`          | Microsoft PowerPoint presentation (older format)    |
    | `application/vnd.ms-powerpoint.presentation.macroEnabled.12`                | `.pptm`         | Microsoft PowerPoint Macro-Enabled Presentation     |
    | `application/vnd.ms-powerpoint.slideshow.macroEnabled.12`                   | `.ppsm`         | Microsoft PowerPoint Macro-Enabled Slide Show       |
    | `application/vnd.ms-powerpoint.template.macroEnabled.12`                    | `.potm`         | Microsoft PowerPoint Macro-Enabled Template         |
    | `application/vnd.ms-word.document.macroEnabled.12`                          | `.docm`         | Microsoft Word Macro-Enabled Document               |
    | `application/vnd.ms-word.template.macroEnabled.12`                          | `.dotm`         | Microsoft Word Macro-Enabled Template               |
    | `application/vnd.oasis.opendocument.presentation`                           | `.odp`          | OpenDocument Presentation                           |
    | `application/vnd.oasis.opendocument.presentation-template`                  | `.otp`          | OpenDocument Presentation template                  |
    | `application/vnd.oasis.opendocument.spreadsheet`                            | `.ods`          | OpenDocument Spreadsheet                            |
    | `application/vnd.oasis.opendocument.text`                                   | `.odt`          | OpenDocument Text document                          |
    | `application/vnd.oasis.opendocument.text-template`                          | `.ott`          | OpenDocument Text document template                 |
    | `application/vnd.openxmlformats-officedocument.presentationml.presentation` | `.pptx`         | Microsoft PowerPoint Open XML presentation          |
    | `application/vnd.openxmlformats-officedocument.presentationml.slideshow`    | `.ppsx`         | Microsoft PowerPoint Open XML slideshow             |
    | `application/vnd.openxmlformats-officedocument.presentationml.template`     | `.potx`         | Microsoft PowerPoint Open XML presentation template |
    | `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`         | `.xlsx`         | Microsoft Excel Open XML spreadsheet                |
    | `application/vnd.openxmlformats-officedocument.spreadsheetml.template`      | `.xltx`         | Microsoft Excel Open XML spreadsheet template       |
    | `application/vnd.openxmlformats-officedocument.wordprocessingml.document`   | `.docx`         | Microsoft Word Open XML document                    |
    | `application/vnd.openxmlformats-officedocument.wordprocessingml.template`   | `.dotx`         | Microsoft Word Open XML document template           |
    | `image/jpeg`                                                                | `.jpg`, `.jpeg` | Joint Photographic Experts Group image              |
    | `image/png`                                                                 | `.png`          | Portable Network Graphics image                     |
    | `image/svg+xml`                                                             | `.svg`          | Scalable Vector Graphics image                      |
    | `image/tiff`                                                                | `.tif`, `.tiff` | Tagged Image File Format                            |
    | `image/webp`                                                                | `.webp`         | Web Picture format                                  |
    | `text/csv`                                                                  | `.csv`          | Comma-Separated Values                              |
    | `text/plain`                                                                | `.txt`          | Plain text document                                 |
    | `text/tab-separated-values`                                                 | `.tsv`          | Tab-Separated Values                                |
  </Accordion>
</AccordionGroup>