diff --git a/common/json_tok.h b/common/json_tok.h
index b0d6d1898..d2b82b97c 100644
--- a/common/json_tok.h
+++ b/common/json_tok.h
@@ -64,6 +64,9 @@ bool json_tok_u64(struct command *cmd, const char *name,
 /*
  * Set the address of @out to @tok.  Used as a callback by handlers that
  * want to unmarshal @tok themselves.
+ *
+ * Usage of this is discouraged.  Writing a local static bespoke handler is
+ * preferred.
  */
 bool json_tok_tok(struct command *cmd, const char *name,
 		  const char *buffer, const jsmntok_t * tok,