diff --git a/docs/CosmWasm/README.md b/docs/CosmWasm/README.md
new file mode 100644
index 00000000000..409f31ebda4
--- /dev/null
+++ b/docs/CosmWasm/README.md
@@ -0,0 +1,13 @@
+<!--
+order: 1
+parent:
+  order: 8
+-->
+
+# CosmWasm smart contracts
+
+>CosmWasm is a smart contracting platform built for the Cosmos ecosystem. Simply put, it's the Cosmos (Cosm) way of using WebAssembly (Wasm) hence the name.
+
+>CosmWasm is written as a module that can plug into the Cosmos SDK. This means that anyone currently building a blockchain using the Cosmos SDK can quickly and easily add CosmWasm smart contracting support to their chain, without adjusting existing logic.
+
+Read more about writing smart contracts with CosmWasm at their [documentation site](https://docs.cosmwasm.com/docs/1.0/), or visit [the repository](https://github.com/CosmWasm/cosmwasm).
diff --git a/x/README.md b/x/README.md
index 32e7b5df8ca..9ae681208c5 100644
--- a/x/README.md
+++ b/x/README.md
@@ -27,3 +27,7 @@ To learn more about the process of building modules, visit the [building modules
 ## IBC
 
 The IBC module for the SDK has moved to its [own repository](https://github.com/cosmos/ibc-go).
+
+## CosmWasm
+
+The CosmWasm module enables smart contracts, and has its [own repository](https://github.com/CosmWasm/cosmwasm) and [documentation site](https://docs.cosmwasm.com/docs/1.0).
\ No newline at end of file