diff --git a/core/src/components/alert/alert.scss b/core/src/components/alert/alert.scss
index 87d9e056e1..36f0a76bb6 100644
--- a/core/src/components/alert/alert.scss
+++ b/core/src/components/alert/alert.scss
@@ -4,6 +4,11 @@
 // --------------------------------------------------
 
 :host {
+  /**
+   * @prop --background: Background of the alert
+   * @prop --min-width: Minimum width of the alert
+   * @prop --max-height: Maximum height of the alert
+   */
   --min-width: #{$alert-min-width};
   --max-height: #{$alert-max-height};
 
diff --git a/core/src/components/alert/readme.md b/core/src/components/alert/readme.md
index 6ec9a0199a..093e7d640c 100644
--- a/core/src/components/alert/readme.md
+++ b/core/src/components/alert/readme.md
@@ -105,6 +105,15 @@ Type: `Promise<void>`
 
 
 
+## CSS Custom Properties
+
+| Name           | Description                 |
+| -------------- | --------------------------- |
+| `--background` | Background of the alert     |
+| `--max-height` | Maximum height of the alert |
+| `--min-width`  | Minimum width of the alert  |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*