diff --git a/docs/content/upgrade-guides/medusa-core/1-8-1.md b/docs/content/upgrade-guides/medusa-core/1-8-1.md
new file mode 100644
index 0000000000..18ea236688
--- /dev/null
+++ b/docs/content/upgrade-guides/medusa-core/1-8-1.md
@@ -0,0 +1,37 @@
+---
+description: 'Actions Required for v.1.8.1'
+sidebar_custom_props:
+  iconName: 'server-stack-solid'
+---
+
+# v1.8.1
+
+Version 1.8.1 of Medusa introduces database schema changes which require running the migrations command.
+
+## Overview​
+
+This release introduces a new column named `description` on Product Categories. It is required to run migrations to ensure your backend works as expected.
+
+---
+
+## How to Update
+
+Run the following command in the root directory of your Medusa Backend:
+
+```bash npm2yarn
+npm install @medusajs/medusa@1.8.1
+```
+
+It's also recommended to update any other Medusa plugins or packages you have installed.
+
+---
+
+## Actions Required​
+
+### Run Migrations​
+
+After updating your Medusa backend and before running it, run the following command to run the latest migrations:
+
+```bash
+medusa migrations run
+```