diff --git a/documentation/guides/migrating-from-v8-to-v9.md b/documentation/guides/migrating-from-v8-to-v9.md
index b6f128a17fa..86b8a8df1f1 100644
--- a/documentation/guides/migrating-from-v8-to-v9.md
+++ b/documentation/guides/migrating-from-v8-to-v9.md
@@ -297,6 +297,12 @@ For `<border-width>` instances that are functions, see the [`border-width()`](#b
 
 For `<border-width>` instances that are hard coded values, see if you can replace it with one of our [new border-width tokens](https://github.com/Shopify/polaris-react/blob/77e8669595a4964ff5ce399967661a7621ea2a4d/src/tokens/token-groups/shape.json), otherwise leave it hardcoded.
 
+#### `icon-size()`
+
+| Function      | Replacement Value/Token |
+| ------------- | ----------------------- |
+| `icon-size()` | `--p-icon-size-medium`  |
+
 #### `ms-high-contrast-color()`
 
 | Function                                             | Replacement Value/Token |