diff --git a/doc/configuration.txt b/doc/configuration.txt
index 083f1f600..ce7000470 100644
--- a/doc/configuration.txt
+++ b/doc/configuration.txt
@@ -4498,7 +4498,7 @@ fullconn <conns>
   See also : "maxconn", "server"
 
 
-grace <time>
+grace <time> (deprecated)
   Maintain a proxy operational for some time after a soft stop
   May be used in sections :   defaults | frontend | listen | backend
                                  yes   |    yes   |   yes  |   yes
diff --git a/src/cfgparse-listen.c b/src/cfgparse-listen.c
index cda55e658..6f324fafa 100644
--- a/src/cfgparse-listen.c
+++ b/src/cfgparse-listen.c
@@ -2602,6 +2602,9 @@ int cfg_parse_listen(const char *file, int linenum, char **args, int kwm)
 		curproxy->grace = val;
 		if (alertif_too_many_args(1, file, linenum, args, &err_code))
 			goto out;
+
+		ha_warning("parsing [%s:%d]: the '%s' is deprecated and will be removed in a future version.\n",
+			   file, linenum, args[0]);
 	}
 	else if (!strcmp(args[0], "dispatch")) {  /* dispatch address */
 		struct sockaddr_storage *sk;