Comments
Add, edit and delete comments about a block, prompt or document in the Comments panel.
Comments are notes about a block, prompt or document, kept beside it in the Comments panel. Use them for anything you want to remember about an item, such as where you used it or what to try next. Comments are never part of the text you copy.
Comments or hidden notes
PromptMason has two ways to keep notes, and they work differently:
- Comments are kept in the Comments panel, apart from the text. You add them with a button and they show with a name and a date.
- Hidden notes are written inside the text of a block or prompt, as
{{! like this }}. They stay in the text where you put them, and are taken out when the text is previewed or copied. See Formatting, block headers and hidden notes.
This page is about comments.
Where the Comments panel is
The panel sits at the bottom of the middle pane, headed Comments, or Comments (3) when an item has three:
- On the Blocks screen, under the list, while a block is selected.
- On the Prompts screen, under the list, while a prompt or document is selected.
- On the Build screen, under the middle pane, once the prompt or document has been saved. A new, unsaved prompt has no comments yet.


Click the heading to open or close the panel. To see more comments at once, drag the panel’s top edge up. It can take up to half the pane.
Comments are a feature you can show or hide. If you don’t see the panel, click Settings in the sidebar, then Features, and turn on Comments. Turning it off hides the panel but keeps your comments.
Open the panel by default
The panel starts closed each time you select an item. To have it start open:
- Click Settings in the sidebar, then Features.
- Under Comments, turn on Expand comments by default.
Add a comment
-
Select the block, prompt or document.
-
Click + (Add comment) on the right of the Comments heading.
-
In the first box, type your name if you want it shown. It starts with the last name you used on this PC; clear it to leave the comment unsigned.
-
Type your comment.


-
Click Save. It works once the comment has some text.
With no comments yet, the open panel says No comments yet — be the first to add one.
The comment shows in the panel with your name (or Anonymous if you left the name empty), and the date and time. Long comments show their first two lines.
Edit a comment
- Click the comment in the panel.
- Change the text, or the name.
- Click Save.
An edited comment shows (edited) after its date.
Delete a comment
- Click the comment in the panel.
- Click Delete.
- Click Delete again to confirm.
Deleting a comment can’t be undone: it doesn’t go to Recently deleted.
Comments in a team library
In a team library, everyone in the library sees an item’s comments. There’s no name box: each comment shows the name of the library member who last saved it, from the library’s member list. See Team libraries.
What happens to comments
- Copying an item. A copy made with Copy in a list doesn’t get the original’s comments.
- Moving an item to another folder or library keeps its comments.
- Export. Export everything covers your personal library, so it includes the comments on items there. A team library’s comments go with that library; an owner can export it (see Export or import a team library). See Export and import.
- Paused library. While your library is paused you can read and delete comments, but not add or change them. See When your library is paused.
If comments don’t load
If the panel shows Could not load comments., select another item and then the same item again. If it keeps happening, close and reopen PromptMason.
Want a hand?
Copy this prompt into Claude, ChatGPT or another AI assistant, and it walks you through it step by step.
I want to leave notes on my prompts in PromptMason about what works and what doesn't. Show me how to add, edit and delete comments, and explain how they differ from hidden notes in the text.
Copy adds a short note about PromptMason and this guide's steps, so the assistant has what it needs.
I want to leave notes on my prompts in PromptMason about what works and what doesn't. Show me how to add, edit and delete comments, and explain how they differ from hidden notes in the text. About PromptMason: a Windows desktop app for building AI prompts from reusable blocks. A person writes blocks (reusable pieces of prompt text), builds prompts from them on the Build screen (or keeps a Markdown document, such as a Skill), and copies a prompt into an AI tool, runs it in PromptMason’s own Chat, or lets a connected AI agent use it through PromptMason’s built-in MCP server (the Chrome extension copies prompts on any website). AI assist, Evaluate and Chat use a local model that runs on the person’s PC, or their own AI provider. The guides are also on PromptMason’s Help screen, and Chat can answer “how do I” questions from them. Libraries hold the blocks and prompts; a person can sync their personal library to their other PCs and share team libraries, both through a folder in cloud storage they already have (OneDrive, Google Drive or Dropbox). Everything synced is encrypted and every edit is signed and checked. A recovery kit (a file plus a code) is the spare copy of the person’s keys, for when every PC is lost. The official guide for this is "Comments": https://promptmason.ai/docs/comments Its full text follows, between the lines. Use it as the source of truth, and if anything I see differs from it, tell me rather than guessing. --- Comments are notes about a block, prompt or document, kept beside it in the **Comments** panel. Use them for anything you want to remember about an item, such as where you used it or what to try next. Comments are never part of the text you copy. ## Comments or hidden notes PromptMason has two ways to keep notes, and they work differently: - **Comments** are kept in the **Comments** panel, apart from the text. You add them with a button and they show with a name and a date. - **Hidden notes** are written inside the text of a block or prompt, as `{{! like this }}`. They stay in the text where you put them, and are taken out when the text is previewed or copied. See [Formatting, block headers and hidden notes](https://promptmason.ai/docs/text-formatting). This page is about comments. ## Where the Comments panel is The panel sits at the bottom of the middle pane, headed **Comments**, or **Comments (3)** when an item has three: - On the **Blocks** screen, under the list, while a block is selected. - On the **Prompts** screen, under the list, while a prompt or document is selected. - On the **Build** screen, under the middle pane, once the prompt or document has been saved. A new, unsaved prompt has no comments yet. Click the heading to open or close the panel. To see more comments at once, drag the panel's top edge up. It can take up to half the pane. Comments are a feature you can show or hide. If you don't see the panel, click **Settings** in the sidebar, then **Features**, and turn on **Comments**. Turning it off hides the panel but keeps your comments. ## Open the panel by default The panel starts closed each time you select an item. To have it start open: 1. Click **Settings** in the sidebar, then **Features**. 2. Under **Comments**, turn on **Expand comments by default**. ## Add a comment 1. Select the block, prompt or document. 2. Click **+** (**Add comment**) on the right of the **Comments** heading. 3. In the first box, type your name if you want it shown. It starts with the last name you used on this PC; clear it to leave the comment unsigned. 4. Type your comment. 5. Click **Save**. It works once the comment has some text. With no comments yet, the open panel says **No comments yet — be the first to add one.** The comment shows in the panel with your name (or **Anonymous** if you left the name empty), and the date and time. Long comments show their first two lines. ## Edit a comment 1. Click the comment in the panel. 2. Change the text, or the name. 3. Click **Save**. An edited comment shows **(edited)** after its date. ## Delete a comment 1. Click the comment in the panel. 2. Click **Delete**. 3. Click **Delete** again to confirm. Deleting a comment can't be undone: it doesn't go to **Recently deleted**. ## Comments in a team library In a team library, everyone in the library sees an item's comments. There's no name box: each comment shows the name of the library member who last saved it, from the library's member list. See [Team libraries](https://promptmason.ai/docs/team-libraries). ## What happens to comments - **Copying an item.** A copy made with **Copy** in a list doesn't get the original's comments. - **Moving an item** to another folder or library keeps its comments. - **Export.** **Export everything** covers your personal library, so it includes the comments on items there. A team library's comments go with that library; an owner can export it (see [Export or import a team library](https://promptmason.ai/docs/export-import#export-or-import-a-team-library)). See [Export and import](https://promptmason.ai/docs/export-import). - **Paused library.** While your library is paused you can read and delete comments, but not add or change them. See [When your library is paused](https://promptmason.ai/docs/paused-library). ## If comments don't load If the panel shows **Could not load comments.**, select another item and then the same item again. If it keeps happening, close and reopen PromptMason. --- How to help me: - Go one step at a time. After each step, ask what I see on screen before giving the next one. - Use the exact words on PromptMason’s buttons and screens, as the guide does. - Never ask me for my recovery code, my recovery kit file, a password or my invite line, and never ask me to paste them here. - Start by asking which step I’m on, or what I see now.