diff --git a/doc/templating.rst b/doc/templating.rst
index e8e4cc415..b3a26c4b1 100644
--- a/doc/templating.rst
+++ b/doc/templating.rst
@@ -200,6 +200,10 @@ Overriding works like this::
 
       {% set script_files = script_files + ["_static/myscript.js"] %}
 
+   .. deprecated:: 1.8.0
+
+      Please use ``.Sphinx.add_js_file()`` instead.
+
 Helper Functions
 ~~~~~~~~~~~~~~~~