diff --git a/src/govuk/components/accordion/accordion.yaml b/src/govuk/components/accordion/accordion.yaml
index f570861f7e..e5b7a20c1f 100644
--- a/src/govuk/components/accordion/accordion.yaml
+++ b/src/govuk/components/accordion/accordion.yaml
@@ -23,11 +23,11 @@ params:
     - name: heading.text
       type: string
       required: true
-      description: The title of each section. If `heading.html` is supplied, this is ignored. Can only include [phrasing content](https://html.spec.whatwg.org/#phrasing-content).
+      description: The title of each section. If `heading.html` is supplied, this is ignored.
     - name: heading.html
       type: string
       required: true
-      description: The HTML content of the header for each section which is used both as the title for each section, and as the button to open or close each section.
+      description: The HTML content of the header for each section which is used both as the title for each section, and as the button to open or close each section. Can only include [phrasing content](https://html.spec.whatwg.org/#phrasing-content).
     - name: summary.text
       type: string
       required: false