Available for beta testing: Annotations in the items list

In the latest Zotero beta, annotations will now show up under their parent attachments in the items list.

Showing annotations in the items list makes it easier to view annotations across a library or collection, and it also makes it possible to search or filter for annotations directly. For example, you can search for all annotations in a collection with a given tag and then create a note from those annotations or copy them to an external text editor with Quick Copy.

In Advanced Search, you can use "Item Type" "is" "Annotation" to match annotations or use the Annotation Text and Annotation Comment search conditions to search for specific parts of the annotation. (It's not currently possible to restrict filtering to annotations in the main window, but it probably makes sense to add that, since, say, a given tag could be present on a regular item as well.)

You can assign tags to selected annotations by dragging them to the tag selector, just like other items.

Selected annotations show up in the item pane, grouped by top-level item. (They're not currently grouped by attachment when there are multiple child attachments, but we'll fix that.)

Please let us know if you run into any problems.
  • edited April 28, 2025
    Very nice!
  • This is great! Thank you!
  • I haven't tested, but may I ask what happens if one item has many annotations associated? Expanding such item would show a row for each annotation? If that was the case, there would be some way/preference to choose non-displaying annotations (or only displaying annotations or displaying them in some summarized way)?

    Thanks!
  • @iagogv: They're nested under attachment items, so they don't show up when you just expand the top-level item.
  • Thanks, interesting!!! Is it possible to hide all annotations that don't match the search criteria (tags, annotation text, or annotation comments) and not just highlight them? This would make more sense, especially when dealing with many annotations. It would avoid having to scroll through all of them to locate the annotations that match the search criteria.

    Perhaps this is already possible and it's just my inexperience that limits me, but thanks for the new features.
  • Very cool feature!

    I wonder if for the "Expand/Collapse Collections or Items List" feature using the "+/–" keys, one "+" could get all first children of items, another "+" could get all the children of the children, etc and same idea for "–".

    This way, I can use "+" to get see all the PDFs and notes that are attachments of my items, and which another "+" I can see any annotations for all those PDFs.
  • You can press right arrow on selected rows to expand those items and reveal attachments and notes without expanding annotations rows. Arrow left would do the opposite by collapsing only one level of rows.
  • yes of course, but +/– is nice for seeing rapidly the attachments etc for all items in the library.
  • Right, but you can do Select All + Right Arrow to expand just the top-level items.
  • ah, of course, thanks
  • Thank you, this is a game changer!
  • Thanks a lot for this cool feature. Since there is no hierarchy between the annotations other than page order, I strongly back the idea of "selective listing" in the items list. LG
  • Oh wow, this is working like a charm!
  • Good idea, but there is a problem. When there is hundreds annotations it is impratical to expand the list.
  • in my version (mac desktop), when i am in a collection, and select a tag from the tag panel, the parent entry automatically expands to view the child (so, reference>pdf>annotations). although it does show all annotations while highlighting the one with the selected tag, I found that if I do cmd a (select all), it automatically ONLY selects the child/annotations that are tagged with that code across all parent entries. notably, it does this whether or not the entries are expanded (and automatically expands them if collapsed)

    Then, if you drag it into a text editor, using quick copy, it pulls only the annotations with the correct tag.

    I'm not sure if this resolves some of the concerns with collapsing/expanding across many tagged entries

    However: "For example, you can search for all annotations in a collection with a given tag and then create a note from those annotations" -- When I try to do this, the note is blank!
  • @MollyCB: Yes, that's how all searches in Zotero work. Select All highlights only the search matches (i.e., the black rows, not the gray context rows).
    However: "For example, you can search for all annotations in a collection with a given tag and then create a note from those annotations" -- When I try to do this, the note is blank!
    Please report that in a new thread, along with a Debug ID for reproducing it.
  • This is awesome. Thank you.
  • edited May 10, 2025
    Edit 2: Another idea: Is it possible to refine the search function in the following way: Adding an option that limits the search (for content, but especially tags with regard to the annotation feature) to pre-selected parent items only? So currently, when I type in a tag, I can limit the search to my whole library and also folders/subfolders within that library. But it would be great, if it was also possible to check a box to "limit search to selected parent items only". Thanks!
  • Wow this is amazing, this will supercharge researchers for sure!
  • It would be super cool if annotations could be moved across PDF. Usecase: preprint gets published and we want to move annotations over. It would have to be quite a smart algorithm trying to find matching words or positions while being flexible enough to allow for changes… probably asking too much ;)
  • Thanks! I like this layout very much. Will it be possible in the not distant future to filter the annotations in the items list by color, much as we can now filter by tag?
  • On filter by tag, I would like to be able to exclude untagged annotations (rather than greying them out). That would help to simplify and focus very much.
  • I don't know how long it will take until this feature becomes available on an actual stable release, and also that working with beta releases in a production environment is a terrible idea, but I've actually been missing this kind of search function since my Mendeley and Acrobat/TextEdit annotation days, and absolutely need it for finishing my PhD thesis (as a matter of fact, I was thinking of using a plugin to convert in-document annotations to top-level ones, but this is, as others have said before me, a game-changer). Count me in on the beta track again!
  • edited 5 days ago
    Okay, I've finally gotten around to installing the latest beta on one of my machines and testing it out. YES! Finally! The feature is already functional enough to suit my needs as it is.

    However, and seeing how we're here to give out feedback, the UX could improve a little bit. It's great that we can expand the linked PDF item on the main list view to see all the annotations and jump right to them on the PDF viewer itself by clicking them, but it would be even nicer to be able to do so from the sidebar (I first attempted to click on them there instead, expecting them to work as links, much like I would on Acrobat Pro/Reader itself, and when they didn't, the whole thing did feel “broken”/unfinished and I was forced to search for alternatives).

    I mean, for power users willing to look for it, it's great that the link functionality is there, but even for those, not having to click on those tiny disclosure triangles just to dig through their attachments and get to the links would be nice.

    As a matter of fact, annotations could even be consolidated into the main, top item's sidebar (i.e. for database items with more than one attachment, annotations could be displayed right away but separated/grouped by attachment, next to or where the old – and now, for many I assume, obsolete – extracted annotations are, which would be very useful for multi-volume documents such as some theses and books).

    Also, annotations are easier to read on the sidebar anyway, as they're displayed on a neat column and not truncated in any way (as aren't our comments when it comes to annotations on highlighted text).

    Being the – AFAIK – first beta with this feature exposed, I assume this is probably something that hasn't been implemented yet, but I'd say it should be a top priority for it to feel fully fleshed out, and hopefully not too hard to solve, seeing how that functionality is already in place elsewhere.

    Obviously, adding extra functionality to the sidebar, such as being able to edit annotations, and/or copying text from them right away would be even cooler; maybe only the “Page XX” header could serve as a link to the PDF viewer, the highlighted text could be selectable for copying (it could even be automatic, or at least show a contextual “Copy” popup button or something), and the annotation itself be an editable text field? Food for thought…
  • I have a question: if the attachment files sync is disabled, will the annotations sync and display on the other devices? Currently the attachments files are not synced, but since the records are in the database, annotations should be viewable even though the files are not downloaded
  • edited 3 days ago
    @joaofrgomes:
    It's great that we can expand the linked PDF item on the main list view to see all the annotations and jump right to them on the PDF viewer itself by clicking them, but it would be even nicer to be able to do so from the sidebar
    You'll be able to edit annotations in the item pane, just like you can in the reader sidebar. That's just not implemented yet. But that's not what this thread is about. You could already view annotations in the item pane by clicking on the attachment item.

    The main purpose of the new functionality here — showing annotations in the items list — is to enable filtering of annotations across a library or collection, which has been a top feature request since we added annotation functionality. When you search for a tag that matches some annotations, the items tree will automatically be expanded to show the matches, so you don't need to click multiple disclosure triangles to see them.
    As a matter of fact, annotations could even be consolidated into the main, top item's sidebar
    They could, but it's a lot of data to show in the top-level item pane, above other content. There's already a button that shows if an attachment has annotations, and you can click it to jump to the attachment item, where the annotations are shown. We might change the behavior there slightly, but one way or another, it'll be no more than one click to view the annotations.
  • @kassiansun: Yes, annotations will sync and show even if the files aren't available locally (e.g., if you're using on-demand downloading).
Sign In or Register to comment.