> For the complete documentation index, see [llms.txt](https://help.rhythms.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rhythms.ai/documents-and-library/add-an-image-from-chat-to-a-document.md).

# Add an image from chat to a document

Attach a screenshot or image in chat and ask the assistant to place it in a document.

You can attach an image to a chat message and ask the Rhythms assistant to add it to a document. The assistant copies the image into the document and places it where you ask, so you do not need to paste it in by hand. You need **Can edit** or higher on the document.

## Add an image

1. Open the document, or know its name.
2. In chat, attach the image (PNG or JPEG).
3. Ask the assistant to add it, for example "Add this screenshot under the Risks section."

The assistant adds the image to the document you have open in this chat. If no document is open, or a new chat does not pick up the document you have open, name the document in your message. If you ask the assistant to create a new document with the image, it creates the document first and then places the image.

The image is stored with the document. Deleting the chat message or the attachment later does not remove it from the document.

## Frequently asked questions

**Can I add more than one image in the same message?** Yes. Say which image goes where. If it is not clear which image you mean, including when you say "add this one" or "add the screenshot" and that message has no new image, the assistant asks rather than guessing or reusing an earlier one on its own.

**Which files can I attach?** The chat uploader accepts only PNG and JPEG images. An image added to a document must be 15 MB or smaller.

**Whose images can the assistant add?** Images you uploaded yourself, and images in a chat thread you take part in.

**What about an image someone else posted in Slack?** It may not be available to the assistant. Attach it yourself if the assistant cannot find it.

**What if the section I named is not in the document?** The assistant tells you, and it does not leave a broken image in the document.

## Related articles

* [Create reviews from templates](https://help.rhythms.ai/documents-and-library/create-reviews-from-layouts.md)
* [View and restore document versions](https://help.rhythms.ai/documents-and-library/view-and-restore-document-versions.md)
* [Share a document](https://help.rhythms.ai/documents-and-library/share-a-document.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.rhythms.ai/documents-and-library/add-an-image-from-chat-to-a-document.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
