diff --git a/documentation/guides/migrating-from-v8-to-v9.md b/documentation/guides/migrating-from-v8-to-v9.md
index 43f25d6d1ee..e895513964d 100644
--- a/documentation/guides/migrating-from-v8-to-v9.md
+++ b/documentation/guides/migrating-from-v8-to-v9.md
@@ -89,6 +89,17 @@ To help you quickly add these functions and mixins back to your repo, we've crea
A list of functions/mixins and their value equivalents or new token values.
+#### `duration()`
+
+| Function | Replacement Value/Token |
+| -------------------------------- | ----------------------- |
+| `duration(none)` | 0 |
+| `duration(fast)` | `--p-duration-100` |
+| `duration()`
`duration(base)` | `--p-duration-200` |
+| `duration(slow)` | `--p-duration-300` |
+| `duration(slower)` | `--p-duration-400` |
+| `duration(slowest)` | `--p-duration-500` |
+
#### `easing()`
| Function | Replacement Value/Token |
@@ -100,16 +111,15 @@ A list of functions/mixins and their value equivalents or new token values.
| `easing(overshoot)` | `cubic-bezier(0.07, 0.28, 0.32, 1.22)` |
| `easing(anticipate)` | `cubic-bezier(0.38, -0.4, 0.88, 0.65)` |
-#### `duration()`
+#### `shadow()`
-| Function | Replacement Value/Token |
-| -------------------------------- | ----------------------- |
-| `duration(none)` | 0 |
-| `duration(fast)` | `--p-duration-100` |
-| `duration()`
`duration(base)` | `--p-duration-200` |
-| `duration(slow)` | `--p-duration-300` |
-| `duration(slower)` | `--p-duration-400` |
-| `duration(slowest)` | `--p-duration-500` |
+| Function | Replacement Value/Token |
+| ---------------------------- | ------------------------ |
+| `shadow(faint)` | `--p-shadow-faint` |
+| `shadow()`
`shadow(base)` | `--p-shadow-base` |
+| `shadow(deep)` | `--p-shadow-deep` |
+| `shadow(layer)` | `--p-shadow-layer` |
+| `shadow(transparent)` | `--p-shadow-transparent` |
## Tokens
@@ -120,6 +130,21 @@ A list of functions/mixins and their value equivalents or new token values.
| `--p-duration-1-0-0` | `--p-duration-100` |
| `--p-duration-1-5-0` | `--p-duration-150` |
+### Shadow
+
+| Token | Replacement Value/Token |
+| --------------------------------- | ---------------------------------- |
+| `--p-card-shadow` | `--p-shadow-card` |
+| `--p-popover-shadow` | `--p-shadow-popover` |
+| `--p-modal-shadow` | `--p-shadow-modal` |
+| `--p-top-bar-shadow` | `--p-shadow-top-bar` |
+| `--p-button-drop-shadow` | `--p-shadow-button` |
+| `--p-button-inner-shadow` | `--p-shadows-inset-button` |
+| `--p-button-pressed-inner-shadow` | `--p-shadows-inset-button-pressed` |
+| `--p-shadow-from-ambient-light` | `rgba(23, 24, 24, 0.05)` |
+| `--p-shadow-from-direct-light` | `rgba(0, 0, 0, 0.15)` |
+| `--p-shadow-from-dim-light` | `rgba(0, 0, 0, 0.2)` |
+
## Removal of the public scss api
Any functions that were being consumed from `build/styles/_public-api.scss` have been removed. The functions can be found in the following permalinks.