diff --git a/substrate/core/network-libp2p/src/lib.rs b/substrate/core/network-libp2p/src/lib.rs
index 1a8e9672c8..dfd1b36b22 100644
--- a/substrate/core/network-libp2p/src/lib.rs
+++ b/substrate/core/network-libp2p/src/lib.rs
@@ -15,6 +15,9 @@
 // along with Substrate.  If not, see <http://www.gnu.org/licenses/>.
 
 //! Networking layer of Substrate.
+//! 
+//! **Important**: This crate is unstable and the API and usage may change.
+//!
 
 mod behaviour;
 mod config;
diff --git a/substrate/core/network/src/lib.rs b/substrate/core/network/src/lib.rs
index f07013004f..1e3a7f1552 100644
--- a/substrate/core/network/src/lib.rs
+++ b/substrate/core/network/src/lib.rs
@@ -19,6 +19,9 @@
 
 //! Substrate-specific P2P networking: synchronizing blocks, propagating BFT messages.
 //! Allows attachment of an optional subprotocol for chain-specific requests.
+//! 
+//! **Important**: This crate is unstable and the API and usage may change.
+//!
 
 mod service;
 mod sync;