Document Revisions

Document Revisions View
Click to open the Document Revisions view.

Set Status
Check the selection box to select all configurations.
Click the Set Status dropdown list to Enable or Disable selected configurations.

Save
Click after modifying the configuration to apply your changes.

Revert Revisions
Click to revert the database to its state at a specified point in time.
You can select whether to revert specific collections or revert all collections.
Only documents are reverted. Other entities (such as ongoing tasks) are not modified by this process.

Enforce Configuration
Click to enforce the revisions configuration.

Create document defaults
Click to define default configuration that will apply to documents in all collections that don't have a
collection-specific configuration defined.

Add a collection-specific configuration
Click to create a configuration for a specific collection.
If default settings were defined, the collection-specific configuration will override them for this collection.

The defined Revisions configuration
Read more below.

Document Defaults
This is the default revisions configuration that applies to all non-conflicting documents in all collections
that don't have a collection-specific configuration defined.
These settings are optional and can be removed.

Conflicting Document Defaults
This pre-defined revisions configuration is for conflicting documents only.
When enabled, a revision is created for each conflicting item.
A revision is also created for the conflict resolution document.

• The Conflicting Document Defaults configuration cannot be removed.
• You can modify this configuration,
  or disable it if not interested in tracking document conflicts using revisions.
• When "Document Defaults configuration" is defined, it overrides these conflict defaults.
• When a "Collection-specific configuration" is defined,
  it also overrides these conflict defaults for the collection defined.

Collections
These are optional collection-specific configurations whose settings override the Document Defaults
and the Conflicting Document Defaults for the collections they are defined for.

Selection Box
Click to select this configuration.
Selected configurations can be enabled or disabled using the Set status button.

Configuration Settings
Read more about the available settings in the sections dedicated to defining them below.

Controls

• Disable/Enable - Click to Enable or Disable the configuration.
• Edit - Click to modify the configuration.
• Remove - Click to remove the configuration.

Create document defaults
Click to define default configuration that will apply to non-conflicting documents in all collections
that don't have a collection-specific configuration defined.

Purge revisions on document delete
Enable if you want document revisions to be deleted when their parent document is deleted.

Limit # of revisions to keep

Enable to limit the number of revisions that will be kept in the revisions storage per document.
Upon revision creation (when the parent document is modified), if the number of revisions exceeds this limit
then older revisions will be purged (starting from the oldest revision).

• Enabling the # of revisions to keep will display the following setting as well:
  
  
  Enable to limit the number of revisions that RavenDB is allowed to purge per document modification.
  

  This will be the maximum number of revisions that RavenDB will purge per document modification,
  even if the number of revisions that pend purging is greater.
  Setting this limit can reserve server resources if many revisions pend purging,
  by dividing the purging between multiple document modifications.
  

Limit # of revisions to keep By Age

Enable to set a revisions age limit.
Revisions older than the defined retention time will be purged when their parent document is modified.

• Enabling the age limit setting will also display the Set # of revisions to delete upon document update
  (see above).

Click OK to keep these default settings, or Cancel.
Confirming will add the new settings to the revisions configuration Defaults section:

Add a collection-specific configuration
Click to define a configuration that applies to a specific collection.
This configuration will override Document Defaults and Conflicting Document Defaults configurations.

Collection
Select or enter a collection to define a configuration for.

Configuration options
These options are similar to those explained above for the default configuration,
the only difference is the configuration scope.

Click OK to keep the configuration, or Cancel.
Confirming will add the new configuration to the Collections section: