diff --git a/core/src/components/slides/readme.md b/core/src/components/slides/readme.md
index 86301bfcaa..b3da8eb7d8 100644
--- a/core/src/components/slides/readme.md
+++ b/core/src/components/slides/readme.md
@@ -70,6 +70,14 @@ Licensed under MIT
 | `update`           | Update the underlying slider implementation. Call this if you've added or removed child slides. |
 
 
+## CSS Custom Properties
+
+| Name                         | Description                                |
+| ---------------------------- | ------------------------------------------ |
+| `--bullet-background`        | Background of the pagination bullets       |
+| `--bullet-background-active` | Background of the active pagination bullet |
+
+
 ----------------------------------------------
 
 *Built with [StencilJS](https://stenciljs.com/)*
diff --git a/core/src/components/slides/slides.scss b/core/src/components/slides/slides.scss
index f80d4796d4..e31bd40c85 100644
--- a/core/src/components/slides/slides.scss
+++ b/core/src/components/slides/slides.scss
@@ -5,6 +5,13 @@
 // --------------------------------------------------
 
 :host {
+  /**
+   * @prop --bullet-background: Background of the pagination bullets
+   * @prop --bullet-background-active: Background of the active pagination bullet
+   */
+
+  // TODO: document progress and scroll bar properties once they're working
+
   display: block;
 
   user-select: none;