Get comments on a share
Let viewers leave feedback directly on your shared links, and read it in the desktop app.
When you publish a share, viewers can leave comments directly on the share page: no separate tool needed. Comments appear in real time for all viewers and are mirrored back to your desktop app so you can see feedback without opening the share page.
Share Comments is in Preview: it is still in development and off until you turn it on. Turn it on in Settings > Lab > Share Comments (the shareCommentsEnabled toggle). Once enabled, new shares will include the comment sidebar.
Leave a comment on a share page#
This is what a viewer does on the share page.
Open the comment sidebar. A floating comment button appears in the bottom-right corner of every share that has commenting enabled. Click it to open the sidebar.
Sign in. Google sign-in is required to leave a comment. Click "Sign in with Google" in the sidebar.
Leave a comment. Type in the sidebar’s comment box and submit. For inline comments, select text first (or click a point on an image/PDF) and use the tooltip that appears.
Real-time updates. New comments from other viewers appear instantly: no refresh needed.
What can a comment point at?#
General comments: free-form feedback not attached to any specific part of the content.
Inline text-selection comments: on markdown, plain-text, code, and SVG shares, the viewer selects text and clicks the "Comment" tooltip that appears. The comment anchors to that selection.
Coordinate-pin comments: on image and PDF shares, the viewer clicks a point on the content. A numbered pin drops at that spot and the comment anchors to those coordinates.
Iframe-bridged comments: for HTML and React shares that run inside a sandboxed iframe, the share page bridges text selections out of the iframe so inline comments work the same way.
Sentence comments: on designed, HTML and markdown shares, the viewer picks a whole sentence and comments on it. A numbered pin marks every commented sentence (see Comment on a sentence).
Comment on a sentence#
A viewer can comment on one sentence of the page from the Reader menu (the open-book button in the top-right corner; see Read a shared page your way).
With a mouse, hover over a sentence and press the small Comment button that appears in the margin.
On a phone, tap a sentence and press the button.
With the keyboard, choose Comment on a sentence in the menu, move between sentences with the arrow keys, press Enter to pick one and Escape to leave.
The comment box opens with that sentence quoted. The button never covers the words, and a viewer who is not signed in yet can sign in first: the sentence they picked is kept.
A sentence with comments gets a small numbered pin beside it (the number is how many comments are on it); press a pin to open that conversation. In the comments panel, press the quote on a comment to light up its sentence in the page.
When the page is updated and a commented sentence is reworded or removed, its comments are not lost: they move to a From an earlier version list in the comments panel, with the sentences they were about and their replies.
Sentence comments are not on the shared series view yet.
Read comments in the desktop app#
Comments section. Select a share in the Shares view. A collapsible Comments section in the detail pane shows all comments with an unresolved count.
Allow comments toggle. Inside the share’s edit form, an "Allow comments" checkbox enables or disables commenting per share.
Inbox notifications. When a new comment arrives, an inbox item is created (controlled by the
shareCommentsNotifyInboxsetting). The notification shows the commenter’s name for single comments and includes a direct link to the share page.
Change the comment settings#
Both live in the Comments group of the Shares panel’s Settings view (the gear in the Shares sidebar header).
Comments on for new shares (
shareCommentsDefaultOn): new shares have commenting enabled by default.Inbox alert on new comments (
shareCommentsNotifyInbox): create an inbox notification when a new comment is posted.
Send comments to a Team Chat channel#
When publishing a share, you can optionally link a Team Chat channel. When a viewer comments on that share, the comment is automatically cross-posted as a thread reply in the linked channel, so team members see feedback without opening the share page.
Managing channels. Right-click any channel in the Team Chat sidebar to manage it. The context menu offers Edit Channel (change the name or topic), Leave Channel (for public channels), and Delete Channel (permanently removes the channel and all its messages: you’ll be asked to confirm). Edit and delete are available to the channel’s creator or a workspace admin.
Custom emoji. Admins can upload custom emoji (party-parrot style: PNG, GIF, or WebP images up to 256 KB) that everyone in the workspace can use in messages, reactions, and custom status. Each custom emoji gets a unique :shortcode:: type it in a message and it renders as the image. Find them in the emoji picker’s Custom tab, or manage them from the admin-only custom emoji dialog.
Link previews. When you paste a URL into a Team Chat message, Yardmaster automatically fetches the page and shows a rich preview card below your message, with the page title, a short description, an image, and the site name. Up to three links per message get previews; direct image URLs (like .png or .jpg) are skipped because they already show inline. All fetches are SSRF-protected so private or internal network addresses are never reached.
Self-profile and availability. At the top of the Team Chat sidebar, your profile strip shows your avatar, online status, name, and custom status. Click it to open a popover where you can set your availability to Online, Away, Do Not Disturb, or Offline.
This overrides automatic presence detection, which is useful since Yardmaster runs around the clock. Clear the override to return to automatic mode. The popover also has an Edit Profile button to update your display name and avatar.
Related
- Share a conversation as a linkTurn an AI session, one message or a highlighted part into a read-only web page anyone can open.
- Report a problem or ask for helpThe bug icon in the toolbar sends a bug report, an idea or a question straight to the Yardmaster team, with the details they need to help.
- Find your way around SettingsA map of the Settings pages, what each one is for, and the Guide page that explains it.