diff --git a/docs/source/metadata.rst b/docs/source/metadata.rst
index 168634ff20..2a45e1dd67 100644
--- a/docs/source/metadata.rst
+++ b/docs/source/metadata.rst
@@ -133,7 +133,7 @@ Additional Metadata Fields by Document Type
 +-------------------------+---------------------+--------------------------------------------------------+
 | ``link_texts``          | HTML                | The text associated with a link in a document.         |
 +-------------------------+---------------------+--------------------------------------------------------+
-| ``links``               | HTML                | List of {”text”: “<the text>, “url”: <the url>} items. |
+| ``links``               | HTML                | List of {”text”: “<the text>, “url”: <the url>} items. This element will be removed in the near future in favor of the above two rows |
 +-------------------------+---------------------+--------------------------------------------------------+
 | ``section``             | EPUB                | Book section title corresponding to table of contents  |
 +-------------------------+---------------------+--------------------------------------------------------+