diff --git a/docs/content/plugins/cms/contentful/customize-contentful.md b/docs/content/plugins/cms/contentful/customize-contentful.md
index 5c1e9b2c9c..c38641bb64 100644
--- a/docs/content/plugins/cms/contentful/customize-contentful.md
+++ b/docs/content/plugins/cms/contentful/customize-contentful.md
@@ -7,6 +7,12 @@ addHowToData: true
 
 In this document, you’ll learn how to customize the Contentful integration with Medusa and how to customize the Gatsby storefront that is connected to Contentful.
 
+:::warning
+
+This guide covers how to customize the Gatsby storefront which is now deprecated. It's recommended to integrate Contentful into either the Next.js storefront or your custom storefront.
+
+:::
+
 ## Overview
 
 Part of what makes the integration between Medusa and Contentful powerful is that it’s completely customizable.
diff --git a/docs/content/plugins/cms/contentful/index.md b/docs/content/plugins/cms/contentful/index.md
index 5eb02f7dfc..c249e1538a 100644
--- a/docs/content/plugins/cms/contentful/index.md
+++ b/docs/content/plugins/cms/contentful/index.md
@@ -228,6 +228,12 @@ To do that:
 
 ## Setup Gatsby Storefront
 
+:::warning
+
+This Gatsby storefront is deprecated. It's recommended to integrate Contentful into either the Next.js storefront or your custom storefront.
+
+:::
+
 In this section, you’ll set up the Gatsby storefront of your Medusa backend.
 
 In your terminal in a different directory of the Medusa backend, run the following command: