# Docs

Upload, create, edit, and share workspace docs from Chat.

Chat can read uploaded files, create new workspace docs, edit existing docs, chart data inline, and save outputs so they are available to workflows and future chats.

## Uploading Files

Attach a file to a message by dragging it into the input, pasting it, or using the attachment button.

Use attachments to:

* Summarize or extract data from a PDF
* Turn a CSV into a table
* Add a document to a knowledge base
* Use an image as reference material

Uploaded files are saved to the workspace as docs and can be opened from the resource panel.

An attached doc is resolved by its file ID and checked against your current document access. Chat receives bounded readable content and supported images. If the file is unavailable or its content is truncated, the context records that limitation. Scheduled Sub Agents can retain the same file references and resolve them again on each run.

## Creating and Editing Docs

Chat can create or edit text-based docs such as Markdown, CSV, JSON, HTML, scripts, and plain text:

* "Write a technical spec for the auth refactor as a markdown doc"
* "Create a CSV of test accounts with name, email, and plan columns"
* "Update the pricing section in this doc"
* "Refactor this script to use async/await"

## Charts and Visualizations

When you ask Chat to show, compare, chart, graph, or visualize data, it answers in the thread with generated UI instead of prose. The answer is a card with a heading, a line, bar, area, or pie chart, a table, and clickable follow-up suggestions.

* "Chart the weekly run counts you just pulled"
* "Compare the three pricing tiers above in a table"
* "Visualize that error trend as a line chart"

Chat charts data that is already in the conversation or on screen. It does not run lookups during a chart turn. Query the table first, then ask for the chart. These visualizations are part of the conversation, not workspace docs. If you want to keep the underlying data, ask Chat to save it as a table or a doc in a separate request.

## Sharing a Doc by Link

You share docs from the **Docs** area of the workspace, not from Chat:

1. Open a doc's share controls
2. Choose an audience: **Workspace** (signed-in members) or **Anyone** (anyone with the link)
3. Choose what the audience can do: **View** or **Edit**

Turning sharing on produces a link of the form `https://app.steelengine.com/d/<token>`. Copy it from the **Share link** field. Turning sharing off invalidates the link. Turning it on again later issues a new token. Managing share links requires permission to update documents in the workspace.

## Common Questions

**Where are docs stored?**

Uploaded and generated docs are saved in the workspace Docs area and can be opened from the resource panel.

**Can workflows use docs created by Chat?**

Yes. Workspace docs can be referenced by workflows and passed into workflow blocks.

**What file types can I attach?**

You can attach images, PDFs, text files, JSON, XML, CSVs, and common document formats. Once attached, they become workspace docs.

**Can Chat generate a presentation or PDF?**

Not from Chat. The PPTX Creator and PDF Creator workflow blocks generate presentations and PDFs. They run on the Temporal Worker and publish the file as a workspace doc. Ask Chat to build a workflow that uses them.
