Heratio Help Center article. Category: Research / Notes.
Research Notes and Annotations
A Guide for Researchers
What are research notes?
Research notes let you capture your own thoughts against the collection. A note has a title, content, optional tags, and a visibility setting, and it can be linked to a specific archival item so your reasoning stays attached to the evidence. You can search, filter, and tag your notes, and export them as PDF or CSV for writing up.
Open your notes from the Research sidebar ("My Notes and Annotations") at /research/annotations.
Key features
- Card grid view of all your notes, with a thumbnail when the linked item has one.
- Search across note titles and content.
- Filter by visibility: private, shared, or public.
- Tag cloud showing every tag you have used, with counts, clickable to filter.
- Link a note to an archival description, an actor, a repository, an accession, or a term.
- Export selected notes, or all notes, as PDF or CSV.
- Per-note PDF and CSV export, plus a permalink to jump straight to a note.
Creating a note
You can add a note from the notes page itself, or while looking at an archival record.
+------------------+
| Click Add Note |
+--------+---------+
|
v
+------------------+
| Enter title |
| (optional) |
+--------+---------+
|
v
+------------------+
| Set visibility |
+--------+---------+
|
v
+------------------+
| Write content |
| (required) |
+--------+---------+
|
v
+------------------+
| Add tags |
| (optional) |
+--------+---------+
|
v
+------------------+
| Save |
+------------------+
| Field | Notes |
|---|---|
| Title | Optional short label. |
| Visibility | Private, shared, or public (see below). Defaults to private. |
| Content | Required. The body of your note. |
| Tags | Optional, comma-separated, for example "genealogy, 19th century, photographs". |
When you create a note from a record, the note is automatically linked to that item.
Visibility
Each note carries one of three visibility settings:
| Visibility | Who can see it |
|---|---|
| Private | Only you (the default) |
| Shared | Project collaborators |
| Public | All researchers |
You can change a note's visibility at any time by editing it.
Finding notes again
The notes page gives you three complementary ways to narrow down:
- Search box - type a term to match titles and content.
- Visibility buttons - show only private, shared, or public notes.
- Tag cloud / tag links - click any tag to show only notes carrying it. Tags also appear as clickable badges on each card.
Each note card carries a permalink so you can link straight to a specific note.
Exporting
- Bulk export: select notes and export them together as PDF or CSV.
- Per-note export: each card has its own PDF and CSV links.
- CSV includes title, content, tags, visibility, and the created date.
- PDF renders a printable page including your name and the note details.
Annotating image regions
When you are working with a digitised image, you can go beyond a plain note and pin an annotation to a specific region of the image. This advanced studio is reached from a record at /research/annotations/{slug} and follows the W3C Web Annotation model, so an annotation can target one or more regions of a canvas. Plain notes and region annotations live side by side.
References
- Source:
packages/ahg-research/andpackages/ahg-information-object-manage/ - Stored in:
research_annotation,research_annotation_v2,research_annotation_target