[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Collapse]Common Concepts
  [Expand]Web.config Modifications
  [Expand]Callback Exception Handling
  [Expand]Client-Side Functionality
  [Expand]Cookies Support
  [Expand]Appearance Customization - Theming
   Icon Collection
  [Expand]Performance Optimization
  [Expand]CSS Image Sprites
   Data Annotation Attributes
   Supported Document Types
  [Expand]Accessibility Support
   Right to Left Support
   HTML Encoding
  [Expand]SharePoint Support
   Mobile Support
  [Collapse]Office Document Management
   [Expand]Document Loading
   [Expand]Document Saving
    Document Hibernation
   Cloud Storage Account Management
  [Expand]Web Farm and Web Garden Support
 [Expand]ASP.NET WebForms Controls
 [Expand]ASP.NET MVC Extensions
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Document Hibernation

Expanded Overview

At the server DocumentManager object level, DevExpress office controls provide the capability to automatically free the server operative memory (RAM) by hibernating inactive open documents. By default, document hibernation is disabled.

If you enable document hibernation, open documents that were idling for a certain time will be released from server memory and saved to the server file system at a specific path. This reduces server memory consumption and prevents the loss of unsaved document changes even if planed IIS process recycling occurs.

Expanded API

The following hibernation settings are available through the API exposed by the DocumentManager object.

Property Name



Switches the hibernation functionality on or off. The default value is false.


Specifies the path to the server directory to which open documents are hibernated after idle timeout expiration.


Specifies the idle timeout for documents. The default value is TimeSpan.FromHours(1).

After this timeout has ended, if an end-user starts interacting with a hibernated document, the document is restored from the file back to the server's RAM. Note that the Undo/Redo history is the only data that is lost after a Spreadsheet timeout (a RichEdit document’s Undo/Redo history is stored on the client-side).


Defines the timeout specifying how long hibernated documents are stored on the server before disposal. The default value is TimeSpan.FromHours(24).

After this timeout has passed, a document file stored in HibernationStoragePath will be completely deleted of and all unsaved end-user document changes will be lost.


Specifies whether or not all open documents should be hibernated.

It is recommended that you define hibernation in the Application_Start handler in Global.asax. In this case, even after a server fails, you are not required to reload the page with the RichEdit or Spreadsheet control in the browser - end-users can continue to work with an open spreadsheet document. Each subsequent request will raise the Application_Start handler and define hibernation settings.

Expanded Example

The following code example demonstrates how hibernation settings can be defined in the Application_Start method. Some of the settings are optional.

Is this topic helpful?​​​​​​​