diff --git a/esphome/components/web_server/web_server.h b/esphome/components/web_server/web_server.h
index b776c955ff..e395f92b5a 100644
--- a/esphome/components/web_server/web_server.h
+++ b/esphome/components/web_server/web_server.h
@@ -484,6 +484,7 @@ class WebServer final : public Component, public AsyncWebHandler {
 #endif
 
 #ifdef USE_MEDIA_PLAYER
+  // Not exposed over HTTP; the stub only satisfies ControllerContract
   void on_media_player_update(media_player::MediaPlayer *) {}
 #endif