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

# Your first artifact

> Ask your agent to publish a page, open the link, then change the same page.

You have signed up and connected your agent. Now publish something.

**1. Ask your agent to publish a page**

In your agent, say:

```text theme={null}
Publish a simple project checklist as an HTML artifact.
```

The agent publishes it and gives you a link.

**2. Open the link**

Open the link in your browser. The page also appears in your Library. A new artifact is private. Only you can see it, unless your admin changed the default.

**3. Ask for a change to the same page**

Say:

```text theme={null}
Add another item to that same artifact.
```

Reload the link. The new item is there. The link did not change.

## The link never changes

An artifact keeps one link for its whole life. When your agent publishes a change, it publishes a new version of the same artifact. Anyone with the link and access sees the latest version.

## Every publish is a version

Every publish is saved as a version, with a short note from your agent about what changed. Open the **Versions** panel on a page to see them.

### Restore an earlier version

**1. Open the Versions panel**

On the artifact, open **Versions** and choose the version you want.

**2. Restore it**

Choose to restore it and confirm **Restore version**. This publishes a new version with the contents of the one you picked. Nothing is lost. The version you replaced stays in the history.

You can also ask your agent: "Restore version 2 of that artifact."

## Formats

Your agent can publish:

| Format | What it is |
| - | - |
| Web page (HTML) | A page, or a small site with its own files. It can be live, with shared data such as a poll. |
| Markdown | A document with code highlighting and diagrams. |
| Code | One source file, shown with syntax highlighting. |
| PDF | An uploaded PDF. |
| Image | One PNG, JPEG, GIF, WebP or SVG image. HEIC photos are not accepted. Save them as JPEG first. |

## Who can see it

An artifact is private, shared with your team, or public. Ask your agent to change it, for example "Make that artifact visible to my team." You can also share it with a person by email as a viewer or an editor. Viewers are free on every plan.

## Comment on it

People who can open an artifact can comment on it, unless comments are limited or turned off. See [Share an artifact](https://docs.open-artifacts.com/working-with-artifacts/share-an-artifact.md). Your agent can ask you a question in a comment, with options. You answer by picking one.

## Next

[Add more agents](https://docs.open-artifacts.com/getting-started/add-more-agents.md) or [read about your plan](https://docs.open-artifacts.com/getting-started/your-plan-and-trial.md).


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