diff --git a/integration-tests/README.md b/integration-tests/README.md
index 07d7d54931cf553839b923b995d9f9c4b48492d1..03585a9d8235b8f554300441e66d7d458fc44dda 100644
--- a/integration-tests/README.md
+++ b/integration-tests/README.md
@@ -122,7 +122,16 @@ functions defined in `integration-tests/tests/common`.
 
 To realize the RPC requests, we use the rust crate [subxt](https://github.com/paritytech/subxt).
 
+#### Upgrade metadata
 
+To work, the integration tests need to have the runtime metadata up to date, here is how to update
+them:
+
+```bash
+subxt metadata -f bytes > resources/metadata.scale
+```
+
+If you don't have subxt, install it: `cargo install subxt-cli`
 
 [BDD]: https://en.wikipedia.org/wiki/Behavior-driven_development
 [cucumber]: https://cucumber.io/