> For the complete documentation index, see [llms.txt](https://doc.anytype.io/anytype-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.anytype.io/anytype-docs/collaborate/discussions.md).

# Discussions

A **Discussion** is a comment thread attached directly to an Object. Instead of switching to a separate Chat to talk about a page, task, or document, you post comments right where the work lives — and the conversation stays attached to that Object forever.

Discussions can be used for collaboration purposes, but it can also be used as an appendix for personal-use. This is great for attaching notes and files to an Object without having it be part of the main content.

<div data-with-frame="true"><figure><img src="/files/hVhFtoIDKBB0Fx3Hjp6i" alt=""><figcaption></figcaption></figure></div>

## Why it matters

When discussions live next to the work, you don't lose context. A reviewer's question, a decision someone made three months ago, a quick "looks good" — all of it stays connected to the Object it's about. Anyone who opens that Object later can read the conversation that shaped it.

This is different from a Chat: Chats are streams of messages organized by topic or person. Discussions are tied to one specific Object.

## How it works

Every Object can hold a Discussion and they support the same rich content as the editor — you're not limited to plain text. It can include:

* Attachments (files, images, embeds)
* Inline links to other Objects with `@` mentions
* Standard text formatting (bold, italic, lists)
* Checkboxes for tracking action items inside a thread
* Code blocks with syntax highlighting

Once posted, you can edit your own messages, react with emoji, and reply to specific posts to build a threaded conversation.

<div data-with-frame="true"><figure><img src="/files/eny97KC2BsFYhDpgIFzA" alt=""><figcaption></figcaption></figure></div>

## Starting a Discussion

1. Open any Object.
2. Click the **Discussion** button at the bottom of the Object.
3. Type your message in the input box at the bottom.
4. Press Enter (or `Cmd/Ctrl + Enter` depending on your Send Message preference)
5. Your discussion appears immediately and notifies other members of the Channel.

<div data-with-frame="true"><figure><img src="/files/Hd5LP7igVOYEkHMSG8Iq" alt=""><figcaption></figcaption></figure></div>

### Replying to a post

Hover over any post and click the reply icon, or right-click the post and choose **Reply**. Your reply is grouped under the original post so the conversation stays organized even when multiple threads are running in parallel.

<div data-with-frame="true"><figure><img src="/files/pN5yxKkXdddDFhaBIVKF" alt=""><figcaption></figcaption></figure></div>

### Reactions

Hover over any post and click the smiley icon to add an emoji reaction. Reactions show a counter when more than one person reacts with the same emoji, and you can click an existing reaction to add or remove your own.

### Editing and deleting

Right-click your own post (or use the three-dot menu on hover) to:

* **Edit** — your post stays in place but is marked as edited
* **Copy text** — copy the post content to your clipboard
* **Delete** — remove the post entirely (this can't be undone)

### Permissions

* **Owners and Editors** can post, edit their own posts, and delete their own posts.
* **Viewers** can read Discussions but cannot post.
* A Discussion is part of the Object — if the Object is deleted, the Discussion goes with it.

### Notifications

By default, you'll be notified about replies to your own posts and reactions to your messages. To customize:

1. Open the Object containing the Discussion.
2. Click the three-dot menu in the Discussion tab.
3. Choose **Enable all**, **Mentions only**, or **Disable all** for that Object's Discussion.

Channel-level notification settings still apply on top of per-Object settings.

## Tips

{% hint style="info" %}
**No collaboration required: use the Discussions area as a personal appendix to your documents.** It separates additional notes and files from the main content area.
{% endhint %}

{% hint style="info" %}
**@-mention people in Discussions** to notify them. The @ menu also lets you mention other Objects, which becomes a clickable link inside the post.
{% endhint %}

{% hint style="info" %}
**Use checkboxes for review action items.** A reviewer can list "fix the heading", "rewrite intro", "add screenshot" as checkboxes. The author can tick them off as work progresses, all without leaving the Object.
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.anytype.io/anytype-docs/collaborate/discussions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.