diff --git a/src/Umbraco.Web.UI/config/UrlRewriting.Release.config b/src/Umbraco.Web.UI/config/UrlRewriting.Release.config
index ce7076bf96..754643cf30 100644
--- a/src/Umbraco.Web.UI/config/UrlRewriting.Release.config
+++ b/src/Umbraco.Web.UI/config/UrlRewriting.Release.config
@@ -2,32 +2,9 @@
+ URLRewriting.net is obsolete and will be removed from Umbraco in the future.
+ If you want to do rewrites, make sure to use IIS URL rewrite: https://www.iis.net/downloads/microsoft/url-rewrite
+ The advantage of using IIS rewrite is that it is much faster, much less CPU intensive and much less memory intensive.
+ -->
diff --git a/src/Umbraco.Web.UI/config/UrlRewriting.config b/src/Umbraco.Web.UI/config/UrlRewriting.config
index 108f53bf5e..754643cf30 100644
--- a/src/Umbraco.Web.UI/config/UrlRewriting.config
+++ b/src/Umbraco.Web.UI/config/UrlRewriting.config
@@ -2,32 +2,9 @@
+ URLRewriting.net is obsolete and will be removed from Umbraco in the future.
+ If you want to do rewrites, make sure to use IIS URL rewrite: https://www.iis.net/downloads/microsoft/url-rewrite
+ The advantage of using IIS rewrite is that it is much faster, much less CPU intensive and much less memory intensive.
+ -->
-
\ No newline at end of file
+