diff --git a/upb/alloc.h b/upb/alloc.h
index 35ca9cf17a..b276b935ca 100644
--- a/upb/alloc.h
+++ b/upb/alloc.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/mem/alloc.h instead
+// IWYU pragma: private, include "upb/mem/alloc.h"
 
 #ifndef UPB_ALLOC_H_
 #define UPB_ALLOC_H_
diff --git a/upb/arena.h b/upb/arena.h
index c9c9223bc6..3d849e09fd 100644
--- a/upb/arena.h
+++ b/upb/arena.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/mem/arena.h instead
+// IWYU pragma: private, include "upb/mem/arena.h"
 
 #ifndef UPB_ARENA_H_
 #define UPB_ARENA_H_
diff --git a/upb/array.h b/upb/array.h
index aa1e2998c3..dafaedf537 100644
--- a/upb/array.h
+++ b/upb/array.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/collections/array.h instead
+// IWYU pragma: private, include "upb/collections/array.h"
 
 #ifndef UPB_ARRAY_H_
 #define UPB_ARRAY_H_
diff --git a/upb/decode.h b/upb/decode.h
index 981c2fa47c..2e55496978 100644
--- a/upb/decode.h
+++ b/upb/decode.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/wire/decode.h instead
+// IWYU pragma: private, include "upb/wire/decode.h"
 
 #ifndef UPB_DECODE_H_
 #define UPB_DECODE_H_
diff --git a/upb/decode_fast.h b/upb/decode_fast.h
index 04a66fbecf..2e927350be 100644
--- a/upb/decode_fast.h
+++ b/upb/decode_fast.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/wire/decode_fast.h instead
+// IWYU pragma: private, include "upb/wire/decode_fast.h"
 
 #ifndef UPB_DECODE_FAST_H_
 #define UPB_DECODE_FAST_H_
diff --git a/upb/def.h b/upb/def.h
index 164b91b072..ebf1d9d3bd 100644
--- a/upb/def.h
+++ b/upb/def.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/reflection/def.h instead
+// IWYU pragma: private, include "upb/reflection/def.h"
 
 #ifndef UPB_DEF_H_
 #define UPB_DEF_H_
diff --git a/upb/encode.h b/upb/encode.h
index 14ce1901e5..37d424fd9c 100644
--- a/upb/encode.h
+++ b/upb/encode.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/wire/encode.h instead
+// IWYU pragma: private, include "upb/wire/encode.h"
 
 #ifndef UPB_ENCODE_H_
 #define UPB_ENCODE_H_
diff --git a/upb/json_decode.h b/upb/json_decode.h
index c27c91be06..816bf013db 100644
--- a/upb/json_decode.h
+++ b/upb/json_decode.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/json/decode.h instead
+// IWYU pragma: private, include "upb/json/decode.h"
 
 #ifndef UPB_JSONDECODE_H_
 #define UPB_JSONDECODE_H_
diff --git a/upb/json_encode.h b/upb/json_encode.h
index e76e1382f1..8189956fd0 100644
--- a/upb/json_encode.h
+++ b/upb/json_encode.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/json/encode.h instead
+// IWYU pragma: private, include "upb/json/encode.h"
 
 #ifndef UPB_JSONENCODE_H_
 #define UPB_JSONENCODE_H_
diff --git a/upb/map.h b/upb/map.h
index ce371c2093..9ce69f69fc 100644
--- a/upb/map.h
+++ b/upb/map.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/collections/map.h instead
+// IWYU pragma: private, include "upb/collections/map.h"
 
 #ifndef UPB_MAP_H_
 #define UPB_MAP_H_
diff --git a/upb/mini_table.h b/upb/mini_table.h
index e0dc2ea9d8..ca8a324f60 100644
--- a/upb/mini_table.h
+++ b/upb/mini_table.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use the header(s) below instead.
+// IWYU pragma: private, include "upb/mini_table/decode.h"
 
 #ifndef UPB_MINI_TABLE_H_
 #define UPB_MINI_TABLE_H_
diff --git a/upb/msg.h b/upb/msg.h
index 1d70f6f0ed..5443a79e56 100644
--- a/upb/msg.h
+++ b/upb/msg.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/message/message.h instead
+// IWYU pragma: private, include "upb/message/message.h"
 
 #ifndef UPB_MSG_H_
 #define UPB_MSG_H_
diff --git a/upb/msg_internal.h b/upb/msg_internal.h
index 39d6d6b210..2cfdae87a3 100644
--- a/upb/msg_internal.h
+++ b/upb/msg_internal.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/message/internal.h instead
+// IWYU pragma: private, include "upb/message/internal.h"
 
 #ifndef UPB_MSG_INT_H_
 #define UPB_MSG_INT_H_
diff --git a/upb/reflection.h b/upb/reflection.h
index 7b751378fa..12f0762cc7 100644
--- a/upb/reflection.h
+++ b/upb/reflection.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/reflection/message.h instead
+// IWYU pragma: private, include "upb/reflection/message.h"
 
 #ifndef UPB_REFLECTION_H_
 #define UPB_REFLECTION_H_
diff --git a/upb/status.h b/upb/status.h
index c16be90029..fcd2bf73ee 100644
--- a/upb/status.h
+++ b/upb/status.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/base/status.h instead
+// IWYU pragma: private, include "upb/base/status.h"
 
 #ifndef UPB_STATUS_H_
 #define UPB_STATUS_H_
diff --git a/upb/string_view.h b/upb/string_view.h
index 0e0faddb1f..add8275281 100644
--- a/upb/string_view.h
+++ b/upb/string_view.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/base/string_view.h instead
+// IWYU pragma: private, include "upb/base/string_view.h"
 
 #ifndef UPB_STRING_VIEW_H_
 #define UPB_STRING_VIEW_H_
diff --git a/upb/text_encode.h b/upb/text_encode.h
index 82aab7689c..b0f5792bda 100644
--- a/upb/text_encode.h
+++ b/upb/text_encode.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use upb/text/encode.h instead
+// IWYU pragma: private, include "upb/text/encode.h"
 
 #ifndef UPB_TEXTENCODE_H_
 #define UPB_TEXTENCODE_H_
diff --git a/upb/upb.h b/upb/upb.h
index 526d3dd9c3..829c99c4ce 100644
--- a/upb/upb.h
+++ b/upb/upb.h
@@ -26,6 +26,7 @@
  */
 
 // This header is deprecated, use the individual #includes below as needed.
+// IWYU pragma: private, include "upb/base/status.h"
 
 #ifndef UPB_H_
 #define UPB_H_