diff --git a/docs/content/advanced/backend/upgrade-guides/1-3-8.md b/docs/content/advanced/backend/upgrade-guides/1-3-8.md
new file mode 100644
index 0000000000..32b77368c8
--- /dev/null
+++ b/docs/content/advanced/backend/upgrade-guides/1-3-8.md
@@ -0,0 +1,33 @@
+# v1.3.8
+
+Updating your medusa server to version `1.3.8` may cause issues when using NPM. Please refer to this guide for more details on how to resolve it.
+
+## Update Using Yarn
+
+We highly recommend using [yarn](https://yarnpkg.com/) when working with Medusa. Updating with yarn should resolve any issues you might run into during the update.
+
+## Resolving Update Issues with NPM
+
+### Update All Medusa Dependencies
+
+If you face any errors during your update to version `1.3.8`, make sure to update all Medusa dependencies you’re using on your server. This includes `medusa-interfaces`, `@medusajs/medusa-cli`, or any of Medusa’s official plugins.
+
+You can update to the latest version of these using the `@latest` version tag. For example:
+
+```bash
+npm install medusa-interfaces@latest
+```
+
+### Use Legacy Peer Dependencies Option
+
+:::caution
+
+This solution can be used as a workaround and should be used with caution to avoid any issues while using Medusa.
+
+:::
+
+If all fails, you can use the `--legacy-peer-deps` option while updating Medusa:
+
+```bash
+npm install @medusajs/medusa@latest --legacy-peer-deps
+```
diff --git a/www/docs/docusaurus.config.js b/www/docs/docusaurus.config.js
index 6c40b715dd..4a7fb6934f 100644
--- a/www/docs/docusaurus.config.js
+++ b/www/docs/docusaurus.config.js
@@ -32,6 +32,14 @@ module.exports = {
     ]
   ],
   themeConfig: {
+    announcementBar: {
+      id: 'release-1-3-8',
+      content:
+        'New Release! Version 1.3.8 of Medusa is out now! Read all about it <a href="https://github.com/medusajs/medusa/releases/tag/v1.3.8">here</a>.',
+      backgroundColor: '#7C53FF',
+      textColor: '#fff',
+      isCloseable: false,
+    },
     colorMode: {
       defaultMode: 'light',
       disableSwitch: false,
diff --git a/www/docs/sidebars.js b/www/docs/sidebars.js
index 6168b365e2..51136b0dc2 100644
--- a/www/docs/sidebars.js
+++ b/www/docs/sidebars.js
@@ -169,6 +169,11 @@ module.exports = {
               id: "advanced/backend/upgrade-guides/1-3-6",
               label: "v1.3.6"
             },
+            {
+              type: "doc",
+              id: "advanced/backend/upgrade-guides/1-3-8",
+              label: "v1.3.8"
+            },
           ]
         },
       ]