diff --git a/workflow-sample/README.md b/workflow-sample/README.md
index 6fe60c9..63e2c8b 100644
--- a/workflow-sample/README.md
+++ b/workflow-sample/README.md
@@ -1,6 +1,9 @@
 # Jahia OSGi Workflow sample
 
-This repository contains samples of workflow registration
+This repository contains samples of workflow registration.
+
+> [!WARNING]  
+> As of Jahia 8.2.4.0, custom workflows are deprecated, and you should not base your module implementation on this sample.
 
 ## How to test it
 
@@ -15,4 +18,4 @@ This module contains :
 - The associated registration in a json file
 - A mail template
 - A custom WorkItem handler, exposed as an OSGi service
-- A custom Assignation valve, exposed as an OSGi service
\ No newline at end of file
+- A custom Assignation valve, exposed as an OSGi service
diff --git a/workflow-sample/pom.xml b/workflow-sample/pom.xml
index d1a6b94..2e498c6 100644
--- a/workflow-sample/pom.xml
+++ b/workflow-sample/pom.xml
@@ -15,7 +15,7 @@
     <version>1.0.0-SNAPSHOT</version>
     <packaging>bundle</packaging>
     <name>Jahia Workflow samples</name>
-    <description>This is a module with Workflow samples</description>
+    <description>This is a module with Workflow samples (deprecated!)</description>
 
     <repositories>
         <repository>