diff --git a/lib/get-macro-options/index.js b/lib/get-macro-options/index.js
index 67e7b60697..8d4a279301 100644
--- a/lib/get-macro-options/index.js
+++ b/lib/get-macro-options/index.js
@@ -186,6 +186,7 @@ function getMacroOptions (componentName) {
       .map(option => ({
         name: `Options for ${option.name}`,
         id: option.slug,
+        description: option.description,
         options: option.params
       }))
   ).concat(
@@ -193,6 +194,7 @@ function getMacroOptions (componentName) {
       .map(option => ({
         name: `Options for ${option.name}`,
         id: option.slug,
+        description: option.description,
         options: getMacroOptionsJson(option.name)
           .map(addSlugs)
           .map(renderNameWithBreaks)
diff --git a/views/partials/_example.njk b/views/partials/_example.njk
index 83a0989550..9fbc432d7c 100644
--- a/views/partials/_example.njk
+++ b/views/partials/_example.njk
@@ -94,7 +94,12 @@
           </p>
           {% for table in macroOptions %}
             <table class="govuk-table app-options__table" id="options-{{ exampleId }}--{{ table.id }}">
-              <caption class="govuk-table__caption govuk-heading-m {% if table.id == 'primary' %} govuk-visually-hidden{% endif %}">{{ table.name | safe }}</caption>
+              <caption class="govuk-table__caption{% if table.id == 'primary' %} govuk-visually-hidden{% endif %}">
+                <h3 class="govuk-heading-m">{{ table.name | safe }}</h3>
+                {% if table.description %}
+                <p class="govuk-body">{{ table.description | safe }}</p>
+                {% endif %}
+              </caption>
               <thead class="govuk-table__head">
                 <tr class="govuk-table__row">
                   <th class="govuk-table__header app-options__limit-table-cell" scope="col">Name</th>