diff --git a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_method_subpage_template/index.md b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_method_subpage_template/index.md
index 92fb85ac635d47c..4b6d59de9410825 100644
--- a/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_method_subpage_template/index.md
+++ b/files/en-us/mdn/writing_guidelines/page_structures/page_types/api_method_subpage_template/index.md
@@ -129,6 +129,11 @@ Here is an example where a method can raise a `DOMException` with a name of `Ind
 - {{jsxref("TypeError")}}
   - : Thrown …
 
+## Description
+
+_Detailed description of how the method behaves_
+_Section omitted if an introductory paragraph (or two) at the top of the page is sufficient._
+
 ## Examples
 
 Note that we use the plural "Examples" even if the page only contains one example.