diff --git a/pom.xml b/pom.xml
index 1155bbef..b141ebc5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -6,7 +6,7 @@
     <packaging>jar</packaging>
     <version>2.2.22-SNAPSHOT</version>
     <name>fabric-java-sdk</name>
-    <description>Java SDK for Hyperledger Fabric</description>
+    <description>Java SDK for Hyperledger Fabric. Deprecated as of Fabric v2.5, replaced by org.hyperledger.fabric:fabric-gateway.</description>
     <url>https://www.hyperledger.org/community/projects</url>
     <licenses>
         <license>
diff --git a/src/main/java/org/hyperledger/fabric/sdk/exception/package-info.java b/src/main/java/org/hyperledger/fabric/sdk/exception/package-info.java
new file mode 100644
index 00000000..19c348ef
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric/sdk/exception/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric.sdk.exception;
diff --git a/src/main/java/org/hyperledger/fabric/sdk/helper/package-info.java b/src/main/java/org/hyperledger/fabric/sdk/helper/package-info.java
new file mode 100644
index 00000000..dab52463
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric/sdk/helper/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric.sdk.helper;
diff --git a/src/main/java/org/hyperledger/fabric/sdk/idemix/package-info.java b/src/main/java/org/hyperledger/fabric/sdk/idemix/package-info.java
new file mode 100644
index 00000000..36f0f2a2
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric/sdk/idemix/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric.sdk.idemix;
diff --git a/src/main/java/org/hyperledger/fabric/sdk/identity/package-info.java b/src/main/java/org/hyperledger/fabric/sdk/identity/package-info.java
new file mode 100644
index 00000000..aedcfa16
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric/sdk/identity/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric.sdk.identity;
diff --git a/src/main/java/org/hyperledger/fabric/sdk/package-info.java b/src/main/java/org/hyperledger/fabric/sdk/package-info.java
new file mode 100644
index 00000000..ff0322fb
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric/sdk/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric.sdk;
diff --git a/src/main/java/org/hyperledger/fabric/sdk/security/certgen/package-info.java b/src/main/java/org/hyperledger/fabric/sdk/security/certgen/package-info.java
new file mode 100644
index 00000000..d7090d99
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric/sdk/security/certgen/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric.sdk.security.certgen;
diff --git a/src/main/java/org/hyperledger/fabric/sdk/security/package-info.java b/src/main/java/org/hyperledger/fabric/sdk/security/package-info.java
new file mode 100644
index 00000000..48272c07
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric/sdk/security/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric.sdk.security;
diff --git a/src/main/java/org/hyperledger/fabric/sdk/transaction/package-info.java b/src/main/java/org/hyperledger/fabric/sdk/transaction/package-info.java
new file mode 100644
index 00000000..3771a7f1
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric/sdk/transaction/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric.sdk.transaction;
diff --git a/src/main/java/org/hyperledger/fabric_ca/sdk/exception/package-info.java b/src/main/java/org/hyperledger/fabric_ca/sdk/exception/package-info.java
new file mode 100644
index 00000000..ee897342
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric_ca/sdk/exception/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric_ca.sdk.exception;
diff --git a/src/main/java/org/hyperledger/fabric_ca/sdk/helper/package-info.java b/src/main/java/org/hyperledger/fabric_ca/sdk/helper/package-info.java
new file mode 100644
index 00000000..6a1eb3bc
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric_ca/sdk/helper/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric_ca.sdk.helper;
diff --git a/src/main/java/org/hyperledger/fabric_ca/sdk/package-info.java b/src/main/java/org/hyperledger/fabric_ca/sdk/package-info.java
new file mode 100644
index 00000000..71066c3f
--- /dev/null
+++ b/src/main/java/org/hyperledger/fabric_ca/sdk/package-info.java
@@ -0,0 +1,10 @@
+/*
+ * Copyright 2023 IBM All Rights Reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @deprecated As of Fabric v2.5, replaced by the <a href="https://hyperledger.github.io/fabric-gateway/">Fabric Gateway client API</a>.
+ */
+package org.hyperledger.fabric_ca.sdk;