From a859b7895e1f87297887f9cc18594879e2ef6c4a Mon Sep 17 00:00:00 2001
From: Oli Juhl <59018053+olivermrbl@users.noreply.github.com>
Date: Wed, 20 Mar 2024 12:12:53 +0100
Subject: [PATCH] docs: Upgrade guide for v1.20.3 (#6753)

---
 .../upgrade-guides/medusa-core/1-20-3.mdx     | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 www/apps/docs/content/upgrade-guides/medusa-core/1-20-3.mdx

diff --git a/www/apps/docs/content/upgrade-guides/medusa-core/1-20-3.mdx b/www/apps/docs/content/upgrade-guides/medusa-core/1-20-3.mdx
new file mode 100644
index 0000000000..1fcc1c69a8
--- /dev/null
+++ b/www/apps/docs/content/upgrade-guides/medusa-core/1-20-3.mdx
@@ -0,0 +1,49 @@
+---
+description: "Actions Required for v.1.20.3"
+sidebar_custom_props:
+  iconName: "server-stack-solid"
+---
+
+# v1.20.3
+
+Version 1.20.3 of Medusa squashes a few bugs in the core, and updates an index on the customer table.
+
+<DocCard item={{
+  type: 'link',
+  href: 'https://github.com/medusajs/medusa/releases/tag/v1.20.3',
+  label: 'Release Notes',
+  customProps: {
+    iconName: "github",
+    html: 'Check the release notes for all changes.',
+  }
+}} />
+
+## Changes
+
+### Customer table index
+
+The multicolumn uniqueness index on the customer table (`email`, `has_account`) has been updated to only apply to rows where `deleted_at` is `null`. This is to allow for the creation of customers that were previously soft-deleted.
+
+This change requires you to run migrations. See section below.
+
+---
+
+## How to Update
+
+Run the following command in your Medusa backend:
+
+```bash npm2yarn
+npm install @medusajs/medusa@1.20.3
+```
+
+To avoid unexpected issues with dependencies, it's also recommended to update all other Medusa plugins or packages you have installed.
+
+## Actions Required
+
+### Run Migrations
+
+After updating your Medusa server and before running it, run the following command to run the latest migrations:
+
+```bash
+npx medusa migrations run
+```