---
title: "Artifacts"
description: "Dashboards, documents and decks built from your datasets, how to share and print them, and their editions."
url: https://www.gatlas.ai/docs/artifacts
markdown_url: https://www.gatlas.ai/docs/artifacts.md
---

# Artifacts

An artifact is a dashboard, a document or a deck that your agent builds for you from your approved datasets. Its charts and figures read your data every time it opens, so the monthly board pack is built once and stays current.

## Build an artifact

You build and change an artifact by asking your agent. The dashboard has no artifact editor. Building one needs your agent connected with a **Read/write** key, since it saves something; see [Agent access](https://www.gatlas.ai/docs/agent-access.md).

1. **Describe what you want to see**: Name the question, the companies and the format. For example:

> Build a dashboard called "Portfolio monthly" with revenue by company for the last 12 months as a bar chart, this month's total revenue as a big number, and a table of the ten largest overdue invoices.

> Turn our monthly P&L for Northwind into a four-page A4 document for the board, with a short written summary on the first page.

2. **Open it in Gatlas**: Your agent replies with where to find it. In the dashboard, open **Artifacts**, under Artifacts in the sidebar, and open it by name.

3. **Change it by asking**: Ask for changes in the same way: "add a line chart of gross margin", "make it a deck", "rename it Portfolio Q3". Gatlas checks each change against your datasets before it saves, and refuses a chart that would not work.

> **Tip:** If your agent says no dataset holds the number you want, build the dataset first, then the artifact. See [Datasets](https://www.gatlas.ai/docs/datasets.md).

## Formats

- **Dashboard**: rows of charts and figures that reflow on a phone. It can group components into tabs.
- **Document**: A4 pages, drawn on screen the way they print.
- **Deck**: 16:9 slides, shown one at a time; the arrow keys move between them.

Inside any format, an artifact is made of components: line, bar, area and pie charts, a single big number, a table, and text. Every chart, number and table reads one approved dataset, so an artifact shows only figures your datasets hold.

## Saved components

**Components**, under Artifacts in the sidebar, lists the charts, big numbers, tables and text your workspace has saved. Ask your agent to save one, then place it in any dashboard, document or deck. Change a saved component, and every artifact it sits in changes with it.

## How figures update

- The figures are as fresh as the datasets they read. When a dataset refreshes, the artifact shows the new numbers the next time it opens. Someone opening it from the share link may see figures from before the latest refresh. Opening it again a moment later shows the current ones.
- If a dataset is renamed, the artifact follows it. If a dataset is deleted or loses its approval, only the components that read it show a notice; the rest of the artifact still draws.
- In Gatlas, people see the artifacts for the companies they have access to.
- An edition is the exception: its figures stay as they were when it was made. See Editions below.

## Share an artifact

**Share link**, next to the artifact's title, shows a link that anyone can open without logging in, and **Copy share link** copies it. The link is always current: it shows the figures as they stand when someone opens it. Share it as a link in a board portal, a wiki or an email, and people click it to open the artifact. It does not show inside another site's page, so a portal or wiki that tries to embed it shows an empty frame. Only admins and above can copy it.

> **Important:** Treat the share link like a password: whoever has it can see the artifact. If it goes somewhere it should not, ask your agent to revoke the share link, and the old link stops working at once. Ask to reissue it for a new link. Revoking and reissuing need a **Read/write** personal or whole-workspace key.

Anyone who can open an artifact can save it as a PDF: click **Download PDF** on the artifact's page or on its shared page. A document gets one page per sheet, a deck one page per slide, and a dashboard as many pages as it needs.

To post it to Slack on a schedule, open **Automations**, under Agents in the sidebar, choose **New automation**, then **Post an artifact to Slack on a schedule**. Each post carries an **Open artifact** button that opens it in Gatlas. See [Automations](https://www.gatlas.ai/docs/automations.md).

## Editions

An edition is a numbered copy of a deck or document, frozen with every figure as it stood when you made it. Send one when the board should read the same numbers next month as today, where the share link is always current. Click **Make a snapshot** on the artifact's page.

Each edition is listed under **Editions** on that page, with the day it was made and the day its data is from. It has its own link that anyone can open without logging in, and **Copy link** copies it. **Download PDF** saves it, and each page's footer names the edition and the day its data is from. The first download takes a few seconds while the PDF is drawn.

> **Important:** **Withdraw** stops an edition's link working for everyone, at once. A withdrawal cannot be undone. You can still download the edition's PDF from the artifact's page. Editions cannot be deleted on their own, only with their artifact.

Only admins and owners whose access is **All companies** can make, copy and withdraw editions, and only of a deck or document. Your agent can make one too: ask it to make an edition of the board pack. This needs a **Read/write** whole-workspace key.

## Delete an artifact

Ask your agent to delete the artifact. It first tells you what will go, including the share link and how many editions are live, and deletes only once you confirm. There is no undo. Deleting an artifact also deletes its editions: every edition's link stops working and their PDFs are gone. Deleting needs a **Read/write** personal or whole-workspace key, and a whole-workspace key once the artifact has editions.
