diff --git a/docs/config.toml b/docs/config.toml
index 230b5e609..8a52a9845 100644
--- a/docs/config.toml
+++ b/docs/config.toml
@@ -69,8 +69,9 @@ home = [ "HTML", "RSS", "SearchIndex" ]
     { name = "Amazon EMR", identifier = "_emr", weight = 900, url = "https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-iceberg-use-cluster.html" },
     { name = "Impala", identifier = "_impala", weight = 1000, url = "https://impala.apache.org/docs/build/html/topics/impala_iceberg.html" },
     { name = "Doris", identifier = "_doris", weight = 1001, url = "https://doris.apache.org/docs/dev/lakehouse/multi-catalog/iceberg" },
-    { name = "PyIceberg", identifier = "_python", weight = 1400, url = "https://py.iceberg.apache.org/"},
+    { name = "PyIceberg", identifier = "_python", weight = 1500, url = "https://py.iceberg.apache.org/"},
     { name = "Integrations", weight = 1100 },
     { name = "API", weight = 1200},
-    { name = "Javadoc", pre = "relative", url = "../../javadoc/latest", weight = 1300} # `url` is populated by the github deploy workflow and is equal to "../../javadoc/<branch name>"
+    { name = "Migration", weight = 1300},
+    { name = "Javadoc", pre = "relative", url = "../../javadoc/latest", weight = 1400} # `url` is populated by the github deploy workflow and is equal to "../../javadoc/<branch name>"
   ]
diff --git a/iceberg-theme/static/img/iceberg-in-place-metadata-migration.png b/iceberg-theme/static/img/iceberg-in-place-metadata-migration.png
new file mode 100644
index 000000000..1ede320f2
Binary files /dev/null and b/iceberg-theme/static/img/iceberg-in-place-metadata-migration.png differ
diff --git a/iceberg-theme/static/img/iceberg-migrateaction-step1.png b/iceberg-theme/static/img/iceberg-migrateaction-step1.png
new file mode 100644
index 000000000..aae5166fd
Binary files /dev/null and b/iceberg-theme/static/img/iceberg-migrateaction-step1.png differ
diff --git a/iceberg-theme/static/img/iceberg-migrateaction-step2.png b/iceberg-theme/static/img/iceberg-migrateaction-step2.png
new file mode 100644
index 000000000..13bb2444b
Binary files /dev/null and b/iceberg-theme/static/img/iceberg-migrateaction-step2.png differ
diff --git a/iceberg-theme/static/img/iceberg-migrateaction-step3.png b/iceberg-theme/static/img/iceberg-migrateaction-step3.png
new file mode 100644
index 000000000..0175101a1
Binary files /dev/null and b/iceberg-theme/static/img/iceberg-migrateaction-step3.png differ
diff --git a/iceberg-theme/static/img/iceberg-snapshotaction-step1.png b/iceberg-theme/static/img/iceberg-snapshotaction-step1.png
new file mode 100644
index 000000000..f66a3b284
Binary files /dev/null and b/iceberg-theme/static/img/iceberg-snapshotaction-step1.png differ
diff --git a/iceberg-theme/static/img/iceberg-snapshotaction-step2.png b/iceberg-theme/static/img/iceberg-snapshotaction-step2.png
new file mode 100644
index 000000000..5e255fffe
Binary files /dev/null and b/iceberg-theme/static/img/iceberg-snapshotaction-step2.png differ