diff --git a/shell/platform/embedder/embedder.h b/shell/platform/embedder/embedder.h
index b12d41a2a3756..60a90f45f94d5 100644
--- a/shell/platform/embedder/embedder.h
+++ b/shell/platform/embedder/embedder.h
@@ -25,6 +25,9 @@
 // - Function signatures (names, argument counts, argument order, and argument
 //   type) cannot change.
 // - The core behavior of existing functions cannot change.
+// - Instead of array of structures, prefer array of pointers to structures.
+//   This ensures that array indexing does not break if members are added
+//   to the structure.
 //
 // These changes are allowed:
 // - Adding new struct members at the end of a structure.