diff --git a/CHANGELOG.md b/CHANGELOG.md
index fb63059..71b6838 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,7 @@
 # Changelog
 
 ### master
+- save and restore tmux pane contents (@laomaiweng)
 
 ### v2.4.0, 2015-02-23
 - add "tmux-test"
diff --git a/README.md b/README.md
index fa22ae8..38edb88 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,8 @@ This plugin goes to great lengths to save and restore all the details from your
   [restoring vim and neovim sessions](#restoring-vim-and-neovim-sessions).
 - restoring bash history (optional, \*experimental*). More details in
   [restoring bash history](#restoring-bash-history-experimental).
+- restoring tmux pane contents (optional, \*experimental*). More details in
+  [restoring pane contents](#restoring-pane-contents-experimental).
 
 Requirements / dependencies: `tmux 1.9` or higher, `bash`.
 
@@ -156,6 +158,15 @@ foreground when saving. `tmux-resurrect` will send history write command
 to each such pane. To prevent these commands from being added to history themselves,
 add `HISTCONTROL=ignoreboth` to your `.bashrc` (this is set by default in Ubuntu).
 
+#### Restoring pane contents (experimental)
+
+To enable saving and restoring tmux pane contents add this line to `.tmux.conf`:
+
+    set -g @resurrect-capture-pane-contents 'on'
+
+This feature works fine, but there may be some glitches as we're
+[actively working on this](https://github.com/tmux-plugins/tmux-resurrect/issues/81).
+
 ### Other goodies
 
 - [tmux-copycat](https://github.com/tmux-plugins/tmux-copycat) - a plugin for