Pangur docsThe trash
Deleting an item, a file or a highlight puts it in the project's trash, where it stays for 30 days. This page explains how to undo a deletion, restore something from the trash, and delete it for good.
When you delete something in your library, Pangur does not remove it straight away. It goes into the project's trash, where it stays for 30 days before it is deleted for good. This is true of an item, of a file or note attached to it, of a library file deleted along with a copy, and of a highlight. While something is in the trash it no longer appears in your library, in search, in Ask's sources or in topics, but you can bring it back exactly as it was.
Undoing a deletion
Straight after you delete something, a message at the foot of the screen says it has moved to the trash, with Undo. Choosing Undo puts it back at once. The message stays for twelve seconds on the web and in the iPhone and iPad app, and with VoiceOver on it stays until you dismiss it.
Undo is offered only while you are online. A deletion you make offline waits on your device until it can be sent, as other changes do (Working offline), and once it has reached the server you can restore it from the trash.
Opening the trash
On the web and in the Mac app, choose Trash in the library's sidebar, under All items and Recently added. On a narrow screen the same choice is in the collection menu above the list. In the iPhone and iPad app, open the collections list and choose Trash at the foot of it.
The trash lists everything deleted in the project, newest first, with the date each thing was deleted. A file, note or highlight whose item is also in the trash is shown under that item. One whose item is still in the library names the item it came from, so that you can tell, for instance, which book a deleted highlight belonged to. The trash can be opened only while you are online, because what is in it is kept on Pangur's server rather than on your device.
Restoring something
Choose Restore beside it (on the iPhone and iPad, swipe the row to the right or hold it). An item comes back with everything that was attached to it when it was deleted: its files, its notes and the highlights in those files, with their topics. A file or highlight whose item is itself in the trash brings that item back with it, because it could not be seen otherwise.
Restoring reaches your other devices through the ordinary sync, in the same way as any other change.
Deleting for good
Things are deleted for good 30 days after they went into the trash. You can do it sooner with Delete forever beside one entry, or with Empty trash, which deletes everything in the trash. Both ask you to confirm, and neither can be undone. Deleting an item for good deletes its files, notes and highlights with it.
Note that a file in the trash still counts towards your plan's storage until it is deleted for good, so emptying the trash is the way to free the space at once (Plans and limits).
Who can delete and restore
Anyone who can edit a project can delete things, restore them and empty the trash. In an organisation's project, members with the viewer role can do none of these. Assistants connected over MCP cannot delete anything or touch the trash, because what they can do to your library is limited to adding to it (Assistants and Pangur). From the command line, pangur delete moves an item to the trash and pangur trash lists, restores and empties it (the command-line reference).
Manage copies and parts
A copy is one set of files that shows a resource. This page explains how to add a copy to an item, choose the copy that Read opens, record how two copies relate, divide a resource into parts, and remove copies you no longer need.
The catalogue
The catalogue is a project's archival tree of repositories, levels of description and manuscripts. This page explains how it is organised and how to build it, either by hand or from a shelfmark written as you would cite it.