diff --git a/message_definitions/v1.0/common.xml b/message_definitions/v1.0/common.xml
index ccf7bd8cd7f..74160053510 100644
--- a/message_definitions/v1.0/common.xml
+++ b/message_definitions/v1.0/common.xml
@@ -4695,8 +4695,21 @@
-
-
+
+ Compass calibration failed: the vehicle orientation is outside the required tolerance.
+
+
+ Compass calibration failed: the radius of the fitted sphere is unrealistically small or large.
+
+
+ Compass calibration failed: offset magnitude too large.
+
+
+ Compass calibration failed: diagonal or off-diagonal scaling values out of valid range.
+
+
+ Compass calibration failed: fitness (RMS residual) exceeds tolerance.
+
Flags in the HIL_SENSOR message indicate which fields have updated since the last message