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

# Save, Share and Publish Canvases

> Keep a dashboard or page Ankra AI made in chat as a canvas, open it again, share it with your organisation, and publish it at a public link.

When Ankra AI makes a dashboard or a page in a conversation, it shows it on the canvas beside the chat. A **canvas** is that dashboard or page saved, so it outlives the conversation: you can open it again, change it, share it with people in your organisation, and publish a copy at a public link.

In this tutorial you save one thing Ankra AI made, find it again under **Canvases**, share it with a colleague, and publish it.

## Before you start

* **A role that may use Ankra AI.** Saving needs it; without it, a save says **Your role cannot save canvases.** See [Ask Ankra](https://docs.ankra.ai/platform/ai-assistant.md).
* **To publish, an organisation admin role, unless your organisation lets members publish.** By default only admins can publish at a public link. When public links are turned off for the organisation, publishing says **Publishing at a public link is turned off for your organisation. An organisation admin can turn it on in the organisation’s settings.**
* **For the CLI steps:** the [Ankra CLI](https://docs.ankra.ai/reference/cli/index.md), signed in.

**1. Ask Ankra AI for a dashboard or a page**

Press `⌘J` (Mac) or `Ctrl+J` (Windows and Linux) to open Ask Ankra, and ask for something you want to keep, for example:

```text theme={null}
Make a dashboard of CPU and memory for each node on my-cluster.
```

What Ankra AI makes opens on the canvas beside the conversation, with **Save** and **Share** above it.

**2. Save it**

Press **Save**. The button now reads **Saved**.

A saved canvas follows the conversation: when Ankra AI writes a new version of the same thing, it is added to the canvas as its next version, and the button reads **Saving the new version…** until it is stored.

If the save does not land, the reason shows under the canvas, for example **It is larger than a canvas can hold (512 KB).** or **Your organisation has as many canvases as it can keep.**

**3. Open it again**

Press **Saved** to open the canvas. Later, open **Find** (`⌘K`) and choose **Canvases**, or go to `/next/canvases`.

**Canvases** lists the dashboards and pages you saved, and the ones people in your organisation shared with you. Search by title, narrow the list to **Dashboards only** or **Pages only**, and pin the ones you open often; **Pinned only** shows just those.

On the canvas's own page, **Undo** and **Redo** move between versions, **Versions** lists every version newest first, **Comments** holds notes for everyone who can open it, and **Continue editing with Ankra** takes it back to Ask Ankra to change it.

**4. Share it with people in your organisation**

On the canvas's page, under **Name and sharing**, choose **Who can open this canvas**:

* **Only you and the people you choose** - nobody else sees it, except the people you choose under **Share with people**.
* **Everyone in your organisation** - everyone in your organisation can open it. Only you and the people you let edit can change it.

To name someone, under **Share with people**, choose the **Person**, set **Access** to **Can view** or **Can edit**, and press **Share**. They are now listed under **Share with people**, and the canvas appears in their **Canvases**. People who can edit can also rename it, change its layout and go back to earlier versions. Only you can change who it is shared with.

**5. Publish it at a public link**

> [tab] Portal
>
> On the canvas's page, under **Public link**, press **Publish at a public link**. The dialog **Share** *title* shows who can open the canvas inside Ankra and whether a copy of it is public.
>
> 1. For a dashboard, choose **What the public link shows**: **Snapshot** (the numbers are read once, now, and never update) or **Live link** (the panels you share read fresh values while the page is open). Only the person who saved the canvas can share live data.
> 2. Choose how long it lasts under **Keep the link working for**: **1 day**, **7 days** or **30 days**. **7 days** is chosen when the dialog opens.
> 3. Read **Exactly what becomes public**, then press **Publish** (**Publish live link** for live data).
> 4. Press **Copy link**.
>
> **Public link** on the canvas's page now says that anyone with the link can open it, without signing in, until the date it shows.

> [tab] CLI
>
> The CLI publishes a file. Read a saved canvas into one, then publish it:
>
> ```bash theme={null}
> ankra canvas library
> ankra canvas get <canvas-id> --content > report.html
> ankra canvas publish report.html --title "Node capacity" --ttl-hours 24
> ```
>
> `publish` prints the public URL on its own last line. Publishing the same file again updates the same page and keeps its URL. It takes HTML, SVG and Markdown files of up to 200,000 characters.

> [!WARNING]
>
> Anyone holding the link can open the page without signing in to Ankra, until it expires. Publish nothing you would not hand to that audience.

## Verify

1. Open the copied link in a private browser window. The page opens without asking you to sign in.
2. Run `ankra canvas list`. The page you published is listed.
3. Ask the colleague you shared with to open **Canvases**. The canvas is in their list.

## Take a public page down

On the canvas's page, under **Public link**, press **Manage the public link**, then **Unpublish** and **Unpublish now** (for live data, **Revoke** and **Revoke now**). The link stops working for everyone right away. Publishing again gives the same link back.

From the CLI, `ankra canvas unpublish <page-id>` does the same, with the ID `ankra canvas list` shows.

## What can go wrong

| What you see | What it means |
| - | - |
| **Someone else in your organisation already saved this from the conversation.** | The thing is already a canvas. Open it from **Canvases**. |
| **Ankra could not read it as a canvas, so it was not saved.** | What Ankra AI made is not something a canvas can hold. Ask it to make the dashboard or page again. |
| **In your organisation only admins can publish at a public link. Ask an organisation admin to publish it.** | Your organisation lets only admins publish. |
| **Only its owner can publish a canvas that is not shared with the whole organisation. Ask them to publish it.** | The canvas is private to its owner and the people they chose. |
| **Your organisation has as many live public pages as it can have. Unpublish one to publish this.** | Take another public page down first. |
| **This dashboard reads more than 50 datasets, more than a public snapshot can hold. Split it into smaller dashboards to publish it.** | Ask Ankra AI to split the dashboard, then publish each part. |
| **Public links are not available on this Ankra platform.** | The Ankra platform you use does not serve public pages. |

## Where to go next

* [Ask Ankra](https://docs.ankra.ai/platform/ai-assistant.md) - everything else you can ask Ankra AI to do.
* [`ankra canvas`](https://docs.ankra.ai/reference/cli/canvas) - every canvas command, including comments and versions.
* [MCP tools](https://docs.ankra.ai/platform/mcp-tools.md) - `publish_canvas` and `unpublish_canvas` for pages Ankra AI made in a conversation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.