diff --git a/_specifications/lsp/3.18/types/diagnostic.md b/_specifications/lsp/3.18/types/diagnostic.md
index 6c40d0958..c02a97cd0 100644
--- a/_specifications/lsp/3.18/types/diagnostic.md
+++ b/_specifications/lsp/3.18/types/diagnostic.md
@@ -34,10 +34,22 @@ export interface Diagnostic {
 	source?: string;
 
 	/**
-	 * The diagnostic's message.
+	 * The diagnostic's message, e.g. 'Unknown type name "int_8_t"'.
 	 */
 	message: string;
 
+	/**
+	 * An optional property to describe this diagnostic's message with more
+	 * details. For example:
+	 * The type name "int_8_t" is unknown. Did you mean any of these types?
+	 * - int
+	 * - int8_t
+	 * Read more about the built-in types [here](file:///path/to/docs.md).
+	 *
+	 * @since 3.18.0
+	 */
+	messageDetails?: string | MarkupContent;
+
 	/**
 	 * Additional metadata about the diagnostic.
 	 *
@@ -155,4 +167,4 @@ export interface CodeDescription {
 	 */
 	href: URI;
 }
-```
\ No newline at end of file
+```