Versions

Prev Next

Version management in Tuleap Document Manager allows you to track the history of documents, update a document while keeping its previous versions, and see who changed what and when.

What is a document version?

A versioned document is a file stored in Tuleap for which each significant modification is saved as a new version.

This means that:

  • All changes are logged.

  • Previous versions can be accessed.

  • You can see who made the modification and when.

This feature ensures complete traceability of a document’s evolution.

Creating a new version of a document

If you drag and drop a file into a folder in the same location as an existing document, Tuleap does not simply replace the old file: it creates a new version of the existing document.

This is very useful when you want to update the content of a file (e.g., Word document, PDF, image, etc.) without losing track of what existed before.

Document management interface showing options to create a new version and other actions.

Creating a new version for a document with fields for version name and changelog.

Viewing a document’s history

Each document maintains a version log:

  • You can see all previous versions.

  • You can view details of each version (for example, date/time, author, etc.).

  • You can optionally revert to a previous version of the document if necessary (depending on permissions).

This history view is essential to track a document’s evolution or restor previous content.

Document versions list showing authors, dates, and version names for updates.

Warning

It is possible to delete a document version, but this action is irreversible. If you delete a version, it will be permanently lost.

Permissions

You must have the appropriate permissions to create or modify a version:

  • The Author role allows creating a new version of the document.

  • The Manager role also allows controlling permissions and the document’s history.

Version-related notifications

Although specific to version history, it is possible to subscribe to notifications to be alerted when a document is modified or a new version is created: simply check the option in the notifications for the document or folder (see the dedicated article).