# Annotation look update

**URL:** <https://forum.xwiki.org/t/annotation-look-update/16106>\
**Category:** Development\
**Tags:** proposal\
**Created:** [December 13, 2024, 2:30pm UTC](https://forum.xwiki.org/t/annotation-look-update/16106 "2024-12-13T14:30:10Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![amilica](https://forum.xwiki.org/user_avatar/forum.xwiki.org/amilica/32/8216_2.png) [@amilica](https://forum.xwiki.org/u/amilica)\
**Post date:** [December 13, 2024, 2:30pm UTC](https://forum.xwiki.org/t/annotation-look-update/16106/1 "2024-12-13T14:30:10Z")

</div>

Heyy guys! 🤩  
I’m here to talk about some improvements related to an annotation’s look.

# Current look of annotations

 ![image](https://forum.xwiki.org/uploads/default/original/2X/8/862f885ffe9e2f17b7fff2a7dd2b16f1b6f77655.png)

## Comparison with current comments

 ![image](https://forum.xwiki.org/uploads/default/original/2X/c/cf628b78ccf673c698811c4e426fd24ffd056fe8.png)

# Issues

- An annotation’s space usage can be optimized,
- its look can be updated to look more modern,
- the shadow color uses the link color, which seems incorrect
- the profile picture occupies a bit too much space
- its look is not cohesive with the comments

# Improvement

 ![annotation](https://forum.xwiki.org/uploads/default/original/2X/6/6399392109b8fe4d77e2f4633559b087e88fa14a.jpeg)

We simplify the look of an annotation.  
The comment will be updated to be cohesive with the new look.

**#1** The profile picture is much smaller, focusing the attention on the text.

**#2** We keep the date & time on the same line with the name of the user.

**#3** We add a “x” icon to close the annotation in a easier way. Currently, the user has to click the annotation icon to close the annotation. Even if we go with this proposal, some users may not understand the idea of clicking on the annotation to close it.

**#4** We add a “Mark as solved” button that when clicked turns an annotation into a simple comment.

“Mark as solved” is a common functionality in many popular software like Google Docs & Notion. Google Docs takes away the highlighting and checks the comment, literally marking it as solved. In Notion, when clicking the check icon, the annotation is completely deleted.

# What do you think?

_Note:_ the look of normal comments and comments with quotes/annotations will be tackled separately.

---

<div class="post-metadata">

**Author:** ![tmortagne](https://forum.xwiki.org/user_avatar/forum.xwiki.org/tmortagne/32/4930_2.png) [@tmortagne](https://forum.xwiki.org/u/tmortagne)\
**Post date:** [December 13, 2024, 3:10pm UTC](https://forum.xwiki.org/t/annotation-look-update/16106/2 "2024-12-13T15:10:32Z")

</div>

Same comment as on [Comments look update](https://forum.xwiki.org/t/comments-look-update/16107) 🙂

The only different I see between the two (aside from the fact that there is no point repeating the quoted text in the annotation view) is the fact that “View thread” does not have a number in the annotation view, but it’s not clear to me why.

> [@amilica](#):
>
> **#4** We add a “Mark as solved” button that when clicked turns an annotation into a simple comment.

It’s a good idea. Note that we don’t have this kind of metadata right now (unless I missed it) so it goes a bit beyond look update.

---

<div class="post-metadata">

**Author:** ![watery](https://forum.xwiki.org/user_avatar/forum.xwiki.org/watery/32/4228_2.png) [@watery](https://forum.xwiki.org/u/watery)\
**Post date:** [December 14, 2024, 1:05pm UTC](https://forum.xwiki.org/t/annotation-look-update/16106/3 "2024-12-14T13:05:46Z")

</div>

> [@amilica](#):
>
> The comment will be updated to be cohesive with the new look.

Is this a good place to ask to not have annotations in comments like regular comments? I find them a bit unreadable - at least on 15.10.x

---

<div class="post-metadata">

**Author:** ![watery](https://forum.xwiki.org/user_avatar/forum.xwiki.org/watery/32/4228_2.png) [@watery](https://forum.xwiki.org/u/watery)\
**Post date:** [December 14, 2024, 1:14pm UTC](https://forum.xwiki.org/t/annotation-look-update/16106/4 "2024-12-14T13:14:09Z")

</div>

Ok, I need to read threads more carefully 😃

> [@amilica](#):
>
> **#4** We add a “Mark as solved” button that when clicked turns an annotation into a simple comment.

Not sure about this, because to me _comments_ are something relative to the whole page; annotations are relative to specific portions of the page.

But:

> [@amilica](#):
>
> _Note:_ the look of normal comments and comments with quotes/annotations will be tackled separately.

Fine, then.

---

<div class="post-metadata">

**Author:** ![vmassol](https://forum.xwiki.org/user_avatar/forum.xwiki.org/vmassol/32/6_2.png) [@vmassol](https://forum.xwiki.org/u/vmassol)\
**Post date:** [December 14, 2024, 4:28pm UTC](https://forum.xwiki.org/t/annotation-look-update/16106/5 "2024-12-14T16:28:17Z")

</div>

> [@watery](#):
>
> > [@amilica](#):
> >
> > **#4** We add a “Mark as solved” button that when clicked turns an annotation into a simple comment.
> 
> Not sure about this, because to me _comments_ are something relative to the whole page; annotations are relative to specific portions of the page.

For me, the “mark as solved” feature (which doesn’t currently exist) should be for both comments and annotations and clicking it should hide the comment or annotation (with an option somewhere to delete hidden comments/annotations).

---

<div class="post-metadata">

**Author:** ![amilica](https://forum.xwiki.org/user_avatar/forum.xwiki.org/amilica/32/8216_2.png) [@amilica](https://forum.xwiki.org/u/amilica)\
**Post date:** [November 14, 2025, 7:16am UTC](https://forum.xwiki.org/t/annotation-look-update/16106/6 "2025-11-14T07:16:03Z")

</div>

**Hello! Adding a general conclusion on this proposal that will be added in proposal page:**

- The UI updates are agreed upon and annotation should look like this (with the note to include the number of replies in a parenthesis: View thread(6))

 ![image](https://forum.xwiki.org/uploads/default/original/2X/4/4ca450b678a4e0f604277866581f9fd4294275ff.jpeg)

- both comments and annotations should have a mark as solved functionality (new feature)

- clicking the mark as solved button would hide the comment/annotation in a expandable section at the end of all comments (“See solved comments“).

I personally don’t think we should add deletion of all solved comments, as this should be part of a batch comments deletion proposal, but if we want to compromise we can still add a “Delete solved comments“ at the top of all comments sections.

Thanks a lot for inputs, I will mark as solved, but feel free to add more comments!

---

<div class="post-metadata">

**Author:** ![vmassol](https://forum.xwiki.org/user_avatar/forum.xwiki.org/vmassol/32/6_2.png) [@vmassol](https://forum.xwiki.org/u/vmassol)\
**Post date:** [July 23, 2026, 2:30pm UTC](https://forum.xwiki.org/t/annotation-look-update/16106/7 "2026-07-23T14:30:37Z")

</div>

> [@amilica](#):
>
> clicking the mark as solved button would hide the comment/annotation in a expandable section at the end of all comments (“See solved comments“).

This has not been agreed, quite the opposite, @tmortagne and myself said the opposite: that we need to have a real “mark as solved” feature (not simply transform the annotations into a comment). Also note that @watery wasn’t sure about this idea of transforming into a comment.

@CharpentierLucas be aware of this when you implement [Loading...](https://jira.xwiki.org/browse/XWIKI-23740)

---

<div class="post-metadata">

**Author:** ![MichaelHamann](https://forum.xwiki.org/user_avatar/forum.xwiki.org/michaelhamann/32/3813_2.png) [@MichaelHamann](https://forum.xwiki.org/u/MichaelHamann)\
**Post date:** [July 23, 2026, 2:33pm UTC](https://forum.xwiki.org/t/annotation-look-update/16106/8 "2026-07-23T14:33:45Z")

</div>

> [@vmassol](#):
>
> @CharpentierLucas be aware of this when you implement [Loading…](https://jira.xwiki.org/browse/XWIKI-23740)

This has already been implemented and is currently waiting for my review: [XWIKI-23740: Improve the UI of Comments: Annotation look by Sereza5 · Pull Request #5928 · xwiki/xwiki-platform · GitHub](https://github.com/xwiki/xwiki-platform/pull/5928) - feel free to also review the implementation.

---

<div class="post-metadata">

**Author:** ![vmassol](https://forum.xwiki.org/user_avatar/forum.xwiki.org/vmassol/32/6_2.png) [@vmassol](https://forum.xwiki.org/u/vmassol)\
**Post date:** [July 23, 2026, 3:43pm UTC](https://forum.xwiki.org/t/annotation-look-update/16106/9 "2026-07-23T15:43:40Z")

</div>

> [@MichaelHamann](#):
>
> This has already been implemented and is currently waiting for my review: [XWIKI-23740: Improve the UI of Comments: Annotation look by Sereza5 · Pull Request #5928 · xwiki/xwiki-platform · GitHub](https://github.com/xwiki/xwiki-platform/pull/5928) - feel free to also review the implementation.

Thx. I know it’s been implemented in the PR which is why I’m raising the problem. I’ve commented in the jira issue too.
