CommunityHire an ExpertSign Up
Item DetailsComments block
Item Details

Comments block

Adding a comments feature to a List Details.

The Comments block lets users add and view comments linked to a specific item in your app — like a project, task, or client. It’s perfect for sharing updates, asking questions, or keeping track of important details in one place.

Key things to know

  • Comments can be enabled from any Item detail blockor any list type block (List, Grid, Table)

  • Comments are always linked to a record — they can’t exist on their own.

  • You don’t need to set up an extra table to store them. Comments are saved directly inside your Softr app.

  • Each record has one comment thread, even if you show it in multiple places.

  • You can show comments as:

    • A block on a details page
    • A side panel (new!) that opens when clicking a button on a list

Examples

Here’s how you can use comments in your app:

  • Projects – Let your team discuss project updates or next steps.

  • Support tickets – Add internal notes or track follow-ups.

  • Clients – Keep a record of conversations or important context.

How to set up Comments block for Item detail block

  1. Enable the Comments block in the Action tab of the Item detail block

    Notion image

  2. Choose if you want to show comments as a block or side panel.

    Notion image

  3. Configure Features, Permissions and Style in Comments Settings

    Notion image

How to set up Comments for a List block

  1. Add a new Item button in the Actions tab → Open Comments.

    Notion image

  2. Note: In this case, the Comments tab can only be visualized in a Side panel.

  3. Configure Features, Permissions, and Style in Comments Settings

Comments settings and customization

Go to Settings → Comments to control how comments work across your app. From there, you can:

  • Add features like Rich text formatting and file upload option.

  • Change the sorting order, visual style, and message text

  • Set who can comment or view comments (e.g. everyone, only Admins)

Notifications

Your app users can toggle Notifications on and off on the comments if they want to be notified by email when a new comment occurs on an item. You can also customize the notification emails that are sent to your users in the Notification section of the Comment Settings menu.

Notion image

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Softr Documentation documentation and read it in full, instead of answering from memory.

https://docs.softr.io/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://docs.softr.io/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.