diff --git a/README.md b/README.md
index 8149ba4..d0f6029 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,5 @@
 # Initia Registry
+
+This repo contains a `chain.json` and `assetlist.json` for a number of chains in Initia ecosystem. A `chain.json` contains data that makes it easy to start running or interacting with a node.
+
+Schema files containing the recommended metadata structure can be found in the `*.schema.json` files located in the root directory. Schemas are still undergoing revision as user needs are surfaced. Optional fields may be added beyond what is contained in the schema files.
\ No newline at end of file