* [Update instructions](/docs/admin/updates)
* [GitHub release page](https://github.com/BookStackApp/BookStack/releases/tag/v25.05)
-**Upgrade Notices**
-
-TODO
-
-- **Title** - Detail
-
TODO - Video
<!-- {{<pt iUZWrk4oxLYc2dFsAPjDyY>}} -->
This is achieved via a new button in the content popover, which is shown when part of the page text
is selected:
-TODO - image of popover with comment
+
Clicking this will start a new comment with a reference to the selected area & text range.
When viewing the page, this will then show as a highlight and marker for that content:
-TODO - Image of inline comment display
+
+
Clicking the comment marker will then open up that comment thread:
-TODO - Image of inline thread
+
From there you can close or read the thread within this inline display, or click the "Jump to thread"
action to jump to the full thread in the comments area, where you can edit or reply where desired.
was made. Clicking on this indicator will jump the user to the relevant section on the page.
If the referenced section no longer exists at all, this indicator will become orange and can't be clicked.
-TODO - Image of range of indicator presentations
+
Some of these features are also supported in the page editor.
When using the new WYSIWYG editor, opening the comments sidebar will show the inline comments
This isn't supported in the markdown or the old default WYSIWYG editor, where the
indicators will instead remain gray to represent being inactive.
-TODO - Image of editor with comments
+
One thing to note is that only the starting comment of a thread can reference content in this way.
This is to avoid a range of confusing user experience scenarios, like having parts of threads duplicated across
To support these kind of scenarios, this release adds the ability to archive comments.
This is an action which shows on a comment like the existing options:
-TODO - Image of archive option, with comment tabs showing
+
In the comments area, you'll now see tabs for jumping between active and archived threads.
Inline comment markers, introduced above, will show based upon which tab is active.
Within the page editor, archived threads can be accessed via a dropdown below active
comment threads.
-TODO - Image in editor sidebar
+
Only the top-most comments have the ability to be archived or unarchived,
to keep management thread-based otherwise you will have parts of threads