diff --git a/docs/manual.rst b/docs/manual.rst
index 21613edf7..6d4359b5d 100644
--- a/docs/manual.rst
+++ b/docs/manual.rst
@@ -1940,6 +1940,7 @@ It contains the following fields::
 			queued_for_checking,
 			checking_files,
 			connecting_to_tracker,
+			downloading_metadata,
 			downloading,
 			finished,
 			seeding,
@@ -2009,6 +2010,9 @@ current task is in the ``state`` member, it will be one of the following:
 |``connecting_to_tracker`` |The torrent has sent a request to the tracker and is      |
 |                          |currently waiting for a response                          |
 +--------------------------+----------------------------------------------------------+
+|``downloading_metadata``  |The torrent is trying to download metadata from peers.    |
+|                          |This assumes the metadata_transfer extension is in use.   |
++--------------------------+----------------------------------------------------------+
 |``downloading``           |The torrent is being downloaded. This is the state        |
 |                          |most torrents will be in most of the time. The progress   |
 |                          |meter will tell how much of the files that has been       |
diff --git a/include/libtorrent/torrent_handle.hpp b/include/libtorrent/torrent_handle.hpp
index a6ae8b7ee..48a17e2ec 100755
--- a/include/libtorrent/torrent_handle.hpp
+++ b/include/libtorrent/torrent_handle.hpp
@@ -119,6 +119,7 @@ namespace libtorrent
 			queued_for_checking,
 			checking_files,
 			connecting_to_tracker,
+			downloading_metadata,
 			downloading,
 			finished,
 			seeding,