diff --git a/docs/docs/installation/upgrading-superset.mdx b/docs/docs/installation/upgrading-superset.mdx
index 270216932e..b4b76bff01 100644
--- a/docs/docs/installation/upgrading-superset.mdx
+++ b/docs/docs/installation/upgrading-superset.mdx
@@ -33,6 +33,13 @@ To upgrade superset in a native installation, run the following commands:
 
 ```bash
 pip install apache-superset --upgrade
+```
+
+## Upgrading Metadata Database
+
+Migrate the metadata database by running:
+
+```bash
 superset db upgrade
 superset init
 ```