diff --git a/docs/src/pages/components/Modal.svx b/docs/src/pages/components/Modal.svx
index 7f584420..e4ddd46f 100644
--- a/docs/src/pages/components/Modal.svx
+++ b/docs/src/pages/components/Modal.svx
@@ -14,7 +14,9 @@
 
 <FileSource src="/framed/Modal/PassiveModal" />
 
-### 3-button modal
+### Multiple secondary buttons
+
+Use the `secondaryButtons` prop to render two secondary buttons for a "3-button modal". The prop is a 2-tuple type that supersedes `secondaryButtonText`.
 
 <FileSource src="/framed/Modal/3ButtonModal" />