Comments

Add descriptive notes to any command chip — before and after the action — so you and your team always understand what each step does. Comments can be typed manually or spoken aloud during recording.

What are Comments?

Every command chip has two comment slots:

Pre-comment — A note shown before the command name. Describes what you're about to do.
Post-comment — A note shown after the command name. Describes what just happened.

Comments are purely for human understanding. They do not affect flow execution in any way. You can add them to both Command chips and Column chips.

Tip: Use Pre-comments to document what you expect to happen ("Enter invoice number in the Amount field"), and Post-comments to confirm the result ("Invoice number was saved successfully").

Adding Comments

If a chip has no comment, a + button appears centered above (for Pre-comment) or below (for Post-comment):

┌─────────────────────────────────────┐ │ [+ Add Pre Comment] │ │ ┌─────────────────────────────┐ │ │ │ ENTER │ │ │ └─────────────────────────────┘ │ │ [+ Add Post Comment] │ └─────────────────────────────────────┘

Click the + button where you want the comment
A text input appears — type your comment
Press Enter or click elsewhere to save
Press Escape to cancel

The + button appears on every chip that doesn't already have a comment in that slot.

Editing Comments

To edit an existing comment:

Double-click the comment text
The text becomes an editable input field
Type your changes and press Enter or click elsewhere to save
Press Escape to revert to the original text

Deleting Comments

To remove a comment:

Double-click the comment text to enter edit mode
Clear all the text
Press Enter — the comment is removed and the + button reappears

Moving Comments Between Chips

You can quickly move a comment to the adjacent chip using the arrow buttons that appear when you hover over a comment row:

Button	When hovered on	Action
◀ (left arrow)	Pre-comment row	Moves the comment text to the Post-comment of the chip above
▶ (right arrow)	Post-comment row	Moves the comment text to the Pre-comment of the chip below

This is useful when you realize a description belongs to a different step in the flow.

Voice Comments During Recording

When you record a flow using the Windows desktop app, you can speak descriptions as you perform each action. DashX converts your speech to text and attaches it as a Pre-comment or Post-comment on the recorded command.

Voice comments are muted by default. This keeps recordings clean on machines where the microphone is not set up, or where speech recognition quality is poor. You can enable them at any time during recording by clicking the Mute button on the recording control panel.

Setup

Voice recognition uses Windows' built-in speech engine (SAPI 5). No additional software is needed on Windows 10 or later. A microphone must be connected and enabled.

Before enabling voice comments, verify your setup in the recording window:

Mic level bar — should move when you speak (green). If it stays flat or shows red, your microphone is too quiet or too loud.
Voice status — should show "Listening..." once you click the Mute button to unmute.
If the status shows errors like "Too quiet" or "Too slow", keep voice muted and add comments manually instead.

How Voice Comments Work

Start a flow recording as usual
Click the Mute button on the recording control panel to unmute (button turns green, status shows "Listening...")
Before performing an action, speak a description — e.g., "Now pressing Enter to confirm"
Then press the key or click the mouse as you normally would
The spoken text is attached as a Pre-comment on the recorded command chip
Speak immediately after an action to attach a Post-comment instead
Repeat for each step: speak, then act

Pro tip: Speak clearly and at a normal pace. The speech engine works best with short, descriptive phrases like "Opening the Settings menu" or "Typing the invoice date".

Voice Controls

The Recording Control Panel shows voice status:

Voice: Muted — Speech recognition is paused (the default state)
Voice: Listening — The speech engine is active and waiting for input
Voice: "your text" — Shows the most recently recognized phrase

Use the Mute button on the recording control panel to toggle voice capture without stopping the recording.

No microphone? No problem. Every recorded action also captures a screenshot (see Live Streaming & Command Screenshots). After recording, click each thumbnail to view the screen at that moment, then use the + button to add the comment manually.

Comments in the Flow Chart View

Comments are also visible in the Flow Detail page (the read-only chart view). Pre-comments appear above the node box, and Post-comments appear below, making it easy to review the annotated flow at a glance.

Tips for Great Comments

Be specific — Instead of "Type text", write "Type the invoice number T-2024-001"
Use present tense — "Press Enter" not "Will press Enter"
Describe the intent — "Confirm the entry and move to the next row" is better than just "Press Enter"
Keep it short — 5–10 words is ideal for at-a-glance readability
Use voice for speed — Speak comments while recording, then edit them later in the editor if needed

Next: Learn about Layout Concepts to understand how Pre, Middle, and Post sections work together.