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

# Canvas

> Canvas is the visual workspace at the heart of nOps. Build interactive dashboards with drag-and-drop widgets, AI-generated visualizations, and real-time cloud cost data.

## Overview

A **canvas** is a flexible, drag-and-drop workspace where you combine data sources, charts, AI chat sessions, and freeform notes into a single view. Canvases auto-save as you work and support version history so you can always roll back to a previous state.

<Tip>
  The fastest way to get started is to create a canvas from one of the **Global Templates**. These are pre-built layouts designed by the nOps team that give you a ready-to-use dashboard in seconds. Prefer to talk first? Try [Ask Clara](/clara/clara-chat) from the Dashboard, then jump into a canvas when you are ready.
</Tip>

***

## Getting started with Global Templates

Global Templates are pre-configured canvas layouts built by the nOps team. They come loaded with the right data sources, chart types, and filters for common cost optimization workflows -- so you can start analyzing costs immediately instead of building from scratch.

<Steps>
  <Step title="Create a new canvas">
    From the **Dashboard** or [Canvas](https://clara.nops.io/canvas), click **Create**. Give your canvas a **name** and choose a **scope** (Private or Shared).
  </Step>

  <Step title="Choose Load Template">
    In the creation dialog, select **Load template** to browse the available templates.
  </Step>

  <Step title="Pick a Global Template">
    Filter by **Global** scope to see the templates provided by nOps. Browse or search for the one that fits your use case, then click to apply it.
  </Step>

  <Step title="Start exploring">
    Your canvas is pre-populated with widgets, data sources, and configurations from the template. You can immediately interact with the data, apply filters, and customize the layout to fit your needs.
  </Step>
</Steps>

You can also start from scratch or follow the onboarding walkthrough:

* **Start fresh** — open an empty canvas and build from the ground up.
* **Start walkthrough** — launch a guided tour that introduces the canvas controls step by step.

***

## Canvas layout

The canvas is a full-page workspace built around an infinite, pannable grid. The key UI areas are:

| Location          | Elements                                                                                                                    |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Top-right**     | Presence avatars, Clara button (<kbd>Cmd</kbd>+<kbd>J</kbd>), Version History, Share Reports (mail icon with pending badge) |
| **Bottom-left**   | Command palette (gear icon), Pan / Selection toggle                                                                         |
| **Bottom-center** | Palette **(+)** button                                                                                                      |
| **Bottom-right**  | Save indicator (idle / saving / saved / error)                                                                              |
| **Minimap**       | Pannable overview of the full canvas, shown inside the viewport                                                             |

***

## Adding widgets (Palette)

The **(+)** button at bottom-center opens the Palette popover. It has two tabs:

### Tools tab

Draggable tool pills you can drop onto the canvas:

* **Scratch Pad** — freeform notes
* **Text Box** — rich text labels and callouts
* **Global Filters** — shared date and dimension filters that drive data source widgets
* **Nexus** — commitment management (visible only on accounts with the Nexus tool enabled)

### Data Sources tab

* **Search** — filter the list by name.
* **Provider filter** — narrow by cloud provider: All, AWS, GCP, or Azure. Data sources for providers your organization has not onboarded are grayed out.
* **Draggable cards** — drag any data source onto the canvas to create a widget.
* **Refresh** — reload the data source list.
* **+ New** — create a new data source (only available on accounts with elevated data source access).

Widgets snap to the grid automatically when dropped.

***

## Widget reference

<AccordionGroup>
  <Accordion title="Data source">
    Connect to a cloud cost data source and visualize it with any of the 19 supported chart types. Configure dimensions, measures, filters, and save the configuration as a reusable preset.
  </Accordion>

  <Accordion title="AI chart">
    A Clara-generated chart or table. Can be created standalone by Clara or linked to a parent data source widget for AI-driven analysis.
  </Accordion>

  <Accordion title="Scratch Pad">
    A simple notepad for freeform notes, checklists, or observations while you work.
  </Accordion>

  <Accordion title="Text Box">
    A rich-text block for adding headings, callouts, or contextual information to your canvas.
  </Accordion>

  <Accordion title="Global Filters">
    A filter widget that drives one or more data source widgets on the same canvas. Set shared date ranges or dimension filters once and apply them everywhere. Data source and AI chart widgets automatically receive global filter values; you can override specific filters per widget when needed (e.g., one chart with a different date range).
  </Accordion>

  <Accordion title="Nexus">
    A commitment and purchase management widget for reviewing reservations and savings plans. Only available on accounts with the Nexus tool enabled.
  </Accordion>

  <Accordion title="Canvas Info">
    An auto-placed header displaying the canvas name, scope badge, owner, and last-updated timestamp. Not saved as a persisted widget — it is always present.
  </Accordion>
</AccordionGroup>

***

## Chart types

Data source widgets support 19 chart types grouped by category:

| Category             | Chart types                           |
| -------------------- | ------------------------------------- |
| **Time series**      | Line, Area                            |
| **Categorical**      | Bar, Horizontal Bar                   |
| **Part-to-whole**    | Pie, Donut, Treemap                   |
| **Distribution**     | Scatter, Heatmap                      |
| **Flow / hierarchy** | Funnel, Waterfall, Sunburst           |
| **Statistical**      | Radar, Parallel, Boxplot, Candlestick |
| **Metrics**          | Counter, Gauge                        |
| **Combination**      | Combo                                 |
| **Data**             | Table                                 |

***

## Configuring a data source widget

<Steps>
  <Step title="Select a chart type">
    Open the widget configuration and choose one of the 19 chart types listed above.
  </Step>

  <Step title="Choose an X-axis dimension">
    Pick the dimension for the horizontal axis (e.g. date, service, region).
  </Step>

  <Step title="Choose Y-axis measure(s)">
    Select one or more measures for the vertical axis (e.g. cost, usage).
  </Step>

  <Step title="Add a series dimension (optional)">
    Choose a series dimension to break down the data by a second attribute, creating grouped or stacked visualizations.
  </Step>

  <Step title="Apply filters">
    Add include or exclude filters and set a date range to narrow the data shown.
  </Step>

  <Step title="Save as preset (optional)">
    Save your chart configuration — chart type, dimensions, measures, and filters — as a reusable preset that you or your team can apply to future widgets.
  </Step>
</Steps>

***

## Chart customization

Data source widgets support a **Chart Settings** panel for fine-tuning the visual appearance of your charts without changing the underlying data.

### Opening the Chart Settings panel

Click the **settings icon** (⚙️) in the top-right corner of any data source widget to open the panel. A second settings panel may also appear to the right of the first, providing additional configuration options.

### Customization options

**Title and labels**

| Option              | Effect                                                             |
| ------------------- | ------------------------------------------------------------------ |
| **Hide Title**      | Remove the chart title from the visualization                      |
| **Custom Title**    | Override the chart title with your own text                        |
| **Hide Legend**     | Remove the legend from the chart                                   |
| **Legend Position** | Choose where the legend appears: auto, top, bottom, left, or right |

**Series formatting**

| Option                 | Effect                                                                                                                                             |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Series Order**       | Reorder the legend and stacking of series (for bar, line, area, and combo charts). Drag series names to rearrange                                  |
| **Series Colors**      | Customize the color of any series by clicking the colored dot next to its name in the Series Order list and selecting a new color from the palette |
| **Hide Labels**        | Remove data labels from chart elements (e.g., bar labels, pie slice labels)                                                                        |
| **Show as % of Total** | **(Pie and Donut charts only)** Display each slice as a percentage of the total value. Labels and tooltips show percentages instead of raw values  |

**Axis and scale**

| Option         | Effect                                                                                           |
| -------------- | ------------------------------------------------------------------------------------------------ |
| **Y-axis Min** | Set the minimum value for the Y-axis (useful for emphasizing variation when all values are high) |
| **Y-axis Max** | Set the maximum value for the Y-axis                                                             |

**Rendering (for large datasets)**

| Option            | Effect                                                                                                                                                                 |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **High Fidelity** | When enabled and your dataset has over 2,000 data points, render using SVG instead of Canvas for crisper visuals (note: may impact performance on very large datasets) |

### Series color customization example

1. Open the **Chart Settings** panel on your widget.
2. Look for the **Series Order** section, which lists all series in your chart.
3. Click the **colored dot** next to any series name to open the color picker.
4. Select a color from the palette or enter a custom hex code.
5. The chart updates in real-time with the new color.

**Note:** Color customizations are specific to each widget and are preserved when you save your canvas.

***

## Clara AI on canvas

On canvas, Clara opens as a dedicated overlay — a different surface from the **Ask Clara** floating panel on Dashboard, Explorer, Feed, and AI Optimization (see [Ask Clara](/clara/clara-chat)).

### Clara overlay

Click the **Clara button** in the top-right corner (or press <kbd>Cmd</kbd>+<kbd>J</kbd>) to open a floating, resizable panel or docked assistant view. Clara can generate charts, answer questions about your data, and create or update widgets directly on the canvas.

### @ mentions in Clara

In the Clara **composer** (overlay or dock on the canvas), type **`@`** to mention a **data source** or **widget** on the current canvas. Pick an item from the list so Clara knows exactly which data or chart you mean. This is especially helpful on busy boards with many widgets.

### Deep links and Clara

Some in-app links open a canvas with Clara already active, skipping an extra click. The address bar is cleaned up automatically once Clara opens, so bookmarks stay clean.

***

## Interacting with widgets

* **Move** — drag a widget by its header to reposition it on the grid.
* **Resize** — drag the bottom-right corner handle.
* **Copy / Paste** — select one or more widgets, then <kbd>Cmd</kbd>+<kbd>C</kbd> to copy and <kbd>Cmd</kbd>+<kbd>V</kbd> to paste.
* **Select all** — <kbd>Cmd</kbd>+<kbd>A</kbd> to select every widget.
* **Delete** — press <kbd>Backspace</kbd> or <kbd>Delete</kbd> to remove selected widgets.
* **Lock canvas** — lock the canvas to prevent accidental moves while reviewing data (<kbd>Cmd</kbd>+<kbd>L</kbd>).
* **Pin to dashboard** — on chart widgets in shared canvases, click the **pin icon** in the widget header to add it to your organization's dashboard. Your organization can pin up to **25** items total (canvas charts and Explorer reports combined); the dashboard lays them out responsively and adds paging when needed.

***

## Keyboard shortcuts

| Shortcut                                                  | Action                      |
| --------------------------------------------------------- | --------------------------- |
| <kbd>Space</kbd>                                          | Toggle Pan / Selection mode |
| <kbd>Home</kbd>                                           | Pan to nearest data source  |
| <kbd>Cmd</kbd>+<kbd>L</kbd>                               | Lock / unlock canvas        |
| <kbd>Cmd</kbd>+<kbd>A</kbd>                               | Select all                  |
| <kbd>Cmd</kbd>+<kbd>D</kbd>                               | Deselect all                |
| <kbd>Cmd</kbd>+<kbd>C</kbd> / <kbd>Cmd</kbd>+<kbd>V</kbd> | Copy / Paste                |
| <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>F</kbd>              | Fit view                    |
| <kbd>Cmd</kbd>+<kbd>J</kbd>                               | Open Clara                  |
| <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>Backspace</kbd>      | Clear all widgets           |
| <kbd>Backspace</kbd> / <kbd>Delete</kbd>                  | Delete selected             |

<Tip>
  On Windows and Linux, substitute <kbd>Ctrl</kbd> for <kbd>Cmd</kbd>.
  Keyboard shortcuts are disabled while your cursor is in a text input, textarea, or content-editable area.
</Tip>

***

## Command palette

Open the command palette by clicking the **gear icon** at the bottom-left of the canvas. It provides quick actions and canvas settings:

**Actions**

| Action                  | Description                                             |
| ----------------------- | ------------------------------------------------------- |
| **Templates**           | Browse and apply canvas templates                       |
| **Clear All Widgets**   | Remove every widget from the canvas (with confirmation) |
| **Chat History**        | View previous Clara chat sessions on this canvas        |
| **Tour**                | Restart the onboarding walkthrough                      |
| **Download Canvas**     | Export the canvas as an image                           |
| **Refresh All Queries** | Re-run every data source query on the canvas            |
| **Fit View**            | Zoom the viewport to show all widgets                   |

**Settings**

| Setting           | Description                                                                                                                   |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Font Size**     | Increase or decrease the base font size for widgets                                                                           |
| **Tooltip Limit** | Increase or decrease the number of items shown in chart tooltips                                                              |
| **Series Limit**  | Increase or decrease the maximum number of data series rendered in charts. Changing this value persists to your user profile. |

***

## Version history

nOps automatically creates a version snapshot when you add, remove, or restore widgets. You can browse the last **10 versions** from the **Version History** button in the top-right corner.

Each version shows:

* **Change type** — add, remove, position change, dimension change, or restore
* **Timestamp** — when the snapshot was created
* **Widget count** — the number of widgets at that point
* **User** — who made the change

Click **Restore** on any version to replace the current canvas with that snapshot. Your current state is automatically saved as a new version before the restore takes effect.

***

## Scopes and sharing

Every canvas has a **scope** that controls visibility and access:

| Scope       | Visibility                                 | Who can create     |
| ----------- | ------------------------------------------ | ------------------ |
| **Private** | Only the owner can view and edit           | Any user           |
| **Shared**  | All organization members can view and edit | Members and admins |

Change a canvas's scope from the scope badge dropdown in the canvas header. When a canvas is shared, presence avatars appear in the top-right corner, and a warning is shown if another user is actively editing.

<Note>
  **Global** canvases are no longer created directly. Use **global templates** instead — any user can apply a global template to create their own canvas from it.
</Note>

### Sharing private canvases

If you have a **private** canvas that you want specific team members to view or edit, create a **share link** for them:

<Steps>
  <Step title="Open your private canvas">
    From the dashboard, open the canvas you want to share.
  </Step>

  <Step title="Open the share dialog">
    Click the **Share Reports** button (mail icon) in the top-right corner of the canvas, and find **Share private canvas link** in the panel.
  </Step>

  <Step title="Select recipients">
    Choose which team members in your organization can access the canvas via the share link.
  </Step>

  <Step title="Share or copy the link">
    Send the recipient an invitation, or copy the share link directly to share via email, chat, or your preferred method.
  </Step>

  <Step title="Manage share links">
    You can view, revoke, or create additional share links from the sharing panel at any time.
  </Step>
</Steps>

**Note:** Share links are **user-specific** — they grant access only to the selected recipients. Other team members cannot use the link to access your private canvas. You can revoke any share link at any time to immediately remove access.

***

## Templates

Templates let you save a canvas layout and reuse it later. They are the recommended way to get started with nOps.

### Global Templates

Global Templates are created by the nOps team and available to every organization. They provide best-practice dashboards for common workflows like cost allocation, savings tracking, and commitment management. When you create a new canvas, selecting a Global Template is the fastest way to get productive.

### Saving your own template

Once you have a canvas layout you like, save it as a template from the **Command palette > Templates > Save as Template**. Choose a name, description, and scope:

* **Private** — visible only to you.
* **Shared** — visible to your organization.
* **Global** — visible to everyone (requires elevated permissions).

You can also assign a **Provider** (AWS, Azure, or GCP) when saving. This tags the template so it appears under the correct cloud-provider filter in the template browser and on the dashboard Global Templates section. Leave it unset if the template is provider-agnostic.

You can optionally add a **prompt** when saving a template. When someone applies the template, Clara will automatically run that prompt on the new canvas — useful for guiding users through a specific analysis or pre-populating charts with a common question.

### Applying a template

Apply a template in two ways:

1. **When creating a canvas** — select **Load template** from the creation dialog.
2. **From the Command palette** — open **Templates**, browse or search, and apply to the current canvas.

In both places, the template browser groups templates by cloud provider (AWS, Azure, GCP). Templates with no provider assigned are listed under **Unassigned**. Use the search bar or scroll within a group to find the right template.

***

## Folders

Organize canvases into **folders** for better structure. New canvases created inside a folder inherit its scope by default (e.g., a canvas created inside a Private folder will be Private). This helps keep your canvases organized as your workspace grows.

***

## Automated chart refresh (canvas data)

Separate from **email** reports (below), you can keep **chart data** on this canvas fresh on a schedule:

1. In the **top toolbar**, open **Auto refresh** (calendar + clock icon).
2. Use **Refresh Now** for an immediate refresh when you have edit access.
3. Turn on **Auto refresh this canvas** to let nOps refresh chart data **about once per day** while the toggle stays on. You can still refresh manually anytime.
4. Review **Past refreshes** in the same menu for recent run status.

<Tip>
  For a deeper refresh that runs chart jobs in the background, use **Shift** + click on **Refresh Now** when the UI offers it — nOps waits for those jobs to finish before reloading the canvas.
</Tip>

***

## Scheduled reports

**Email reports** are different from the **Auto refresh** menu above: here you configure messages sent to people’s inboxes with a snapshot of the canvas.

Click the **Share Reports** button (mail icon) in the top-right corner of the canvas to send or schedule email reports.

### Send now

Select recipients, add a subject and message, and send immediately. The report includes a captured thumbnail of the current canvas state.

### Schedule recurring

Set a recurring schedule — daily, weekly, or monthly — with your preferred time. Scheduled reports run automatically and are delivered to the selected recipients.

You can view all pending and past scheduled reports for the canvas from the same panel, and cancel any upcoming report at any time. The badge on the Share Reports button shows the number of pending scheduled reports.

***

<Card title="Next: Users and roles" icon="arrow-right" href="/platform/users">
  Learn how to invite team members, assign roles, and manage permissions.
</Card>
