diff --git a/src/components/modal/modal.ios.scss b/src/components/modal/modal.ios.scss
index 40854e802f..fd9f124cf4 100644
--- a/src/components/modal/modal.ios.scss
+++ b/src/components/modal/modal.ios.scss
@@ -3,7 +3,10 @@
 // iOS Modals
 // --------------------------------------------------
 
+/// @prop - Background color for the modal
 $modal-ios-background-color:          $background-ios-color !default;
+
+/// @prop - Border radius for the modal
 $modal-ios-border-radius:             5px !default;
 
 .ios .modal-wrapper {
diff --git a/src/components/modal/modal.md.scss b/src/components/modal/modal.md.scss
index 7c6eb35509..868fcce9cc 100644
--- a/src/components/modal/modal.md.scss
+++ b/src/components/modal/modal.md.scss
@@ -3,6 +3,7 @@
 // Material Design Modals
 // --------------------------------------------------
 
+/// @prop - Background color for the modal
 $modal-md-background-color:          $background-md-color !default;
 
 .md .modal-wrapper {
diff --git a/src/components/modal/modal.scss b/src/components/modal/modal.scss
index ea4ab5307c..94fefe3918 100644
--- a/src/components/modal/modal.scss
+++ b/src/components/modal/modal.scss
@@ -3,11 +3,22 @@
 // Modals
 // --------------------------------------------------
 
+/// @prop - Min width of the modal inset
 $modal-inset-min-width:                      768px !default;
+
+/// @prop - Min height of the small modal inset
 $modal-inset-min-height-small:               600px !default;
+
+/// @prop - Min height of the large modal inset
 $modal-inset-min-height-large:               768px !default;
+
+/// @prop - Width of the large modal inset
 $modal-inset-width:                          600px !default;
+
+/// @prop - Height of the small modal inset
 $modal-inset-height-small:                   500px !default;
+
+/// @prop - Height of the large modal inset
 $modal-inset-height-large:                   600px !default;
 
 ion-modal {
diff --git a/src/components/modal/modal.wp.scss b/src/components/modal/modal.wp.scss
index 69532a6dd9..b369cdc197 100644
--- a/src/components/modal/modal.wp.scss
+++ b/src/components/modal/modal.wp.scss
@@ -3,6 +3,7 @@
 // Windows Modals
 // --------------------------------------------------
 
+/// @prop - Background color for the modal
 $modal-wp-background-color:          $background-wp-color !default;
 
 .wp .modal-wrapper {