diff --git a/tools/fix-h1s.sh b/tools/fix-h1s.sh
new file mode 100755
index 0000000000..ccc6c31fb6
--- /dev/null
+++ b/tools/fix-h1s.sh
@@ -0,0 +1,22 @@
+#!/bin/bash -ex
+
+usage() {
+cat <<EOF
+Usage: $0 <root-dokka-dir>
+EOF
+}
+
+if [ "$#" -ne 1 ] ; then
+  usage
+  exit 1
+fi
+
+# Assume Dokka has been run
+pushd $1
+
+# Make the output SEO friendly by converting the "h2" title to the proper "h1".
+# For Dokka, this is only an issue on the index page (apparently).
+sed -i -e 's|<h2\(.*\)</h2>|<h1\1</h1>|' index.html
+find . -iname "*.html-e" | xargs rm
+
+popd
diff --git a/tools/publish_release.sh b/tools/publish_release.sh
index 5ecd8eb94b..a27818fbcd 100644
--- a/tools/publish_release.sh
+++ b/tools/publish_release.sh
@@ -108,6 +108,7 @@ create_javadoc() {
   echo "Creating JavaDoc/KDoc..."
   cd $REALM_KOTLIN_PATH/packages
   ./gradlew dokkaHtmlMultiModule --info --stacktrace --no-daemon
+  ../tools/fix-h1s.sh build/dokka/htmlMultiModule
   cd $HERE
 }