# Create artifacts

> Publish a page, files or a filled template and get a private link.

Kind: guide · ~2 min · Verified v0.237.0 · Next: [Edit and export documents](https://pr-2197-stg.superartifacts.app/docs/documents.md)

## Goal

Publish the page or files your agent made.

## What you'll have

A stable link and a numbered version you can restore later.

## Needs

A [connected agent](https://pr-2197-stg.superartifacts.app/docs/connect.md) with write permission and the content to publish. Ask for **private** explicitly. A reused slug updates the artifact in the key's workspace; publishing from another workspace can create a separate artifact.

## Prompt

**Publish this.** Your agent publishes what you made and returns its private link.

```prompt
Publish what we just made as a Super Artifacts page and send me the link. Keep it private.
```

## Steps

### What the agent sends

1. Send a complete page as `html`, optionally with small assets in `files`, or choose a `template` and fill its `values`. Stage larger files through `super_upload`; `uploads` includes them and `valuesFile` can identify staged JSON.
2. Set `visibility: "private"` for privacy from the first version. Omission uses the workspace default for a new artifact and keeps the audience on an update. Public access is a separate change after publication.
3. Include a `policy` if the page stores visitor answers. Without one, its form stores nothing on the platform.
4. Open the returned URL. `prompt` is optional publication metadata, not an instruction that the platform runs.

### Seven kinds

| Kind | What a visitor does |
| --- | --- |
| page | Read |
| slideshow | Advance through |
| survey | Answer |
| tracker | Add entries to |
| video | Watch |
| tool | Operate |
| dashboard | Watch numbers move |

Kind describes the page's purpose; `page` is the default.

### Versions keep the link

```mermaid
%% hand-drawn: public/docs/diagrams/versions.svg is an animated SVG; this is its text twin.
flowchart LR
  v1["v1"] --- v2["v2"] --- v3["v3"]
  L(["live pointer"]) -. publish moves it .-> v3
  U["superart.page/{id}"] --> L
```

The same slug creates another version at the same URL. Restoring changes the live version without rebuilding.

## Check it worked

The returned link loads the intended content and **Versions** lists the publication. Check **Share** before sending the link.

## If not

Read the refusal before retrying. `plan_limit` refuses growth when storage is full and deletes nothing. After a timeout, inspect the artifact's versions before publishing again.

## Variations

Official document templates can carry editable source for people and agents to co-edit. [Signatures](https://pr-2197-stg.superartifacts.app/docs/signatures.md) pin an eligible published version.

For a document with stored source, live editing and exports, follow [Edit and export documents](https://pr-2197-stg.superartifacts.app/docs/documents.md).

## Next

[Get feedback](https://pr-2197-stg.superartifacts.app/docs/comments.md) or [collect responses](https://pr-2197-stg.superartifacts.app/docs/collect-data.md).
