diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index d4fde379..60526039 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -85,7 +85,9 @@ jobs:
             echo "value=false" >> "$GITHUB_OUTPUT"
           fi
       - name: Check release notes exist
-        run: test -f "metadata/en-US/changelogs/${{ needs.build.outputs.version-code }}.txt"
+        run: |
+          test -f "metadata/en-US/changelogs/${{ needs.build.outputs.version-code }}.txt"
+          test -f "docs/releases/$GITHUB_REF_NAME.md"
       - name: Write Play service account
         if: steps.stable.outputs.value == 'true'
         env:
@@ -123,7 +125,7 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          args=(--verify-tag --title "$GITHUB_REF_NAME" --notes-file "metadata/en-US/changelogs/${{ needs.build.outputs.version-code }}.txt")
+          args=(--verify-tag --title "$GITHUB_REF_NAME" --notes-file "docs/releases/$GITHUB_REF_NAME.md")
           if [ "${{ steps.stable.outputs.value }}" != "true" ]; then
             args+=(--prerelease)
           fi
diff --git a/docs/releases/v3.1.0.md b/docs/releases/v3.1.0.md
new file mode 100644
index 00000000..f64d0166
--- /dev/null
+++ b/docs/releases/v3.1.0.md
@@ -0,0 +1,24 @@
+## What's new
+
+- ReplayGain: normalizes loudness from the tags your server reports. Auto, the default, uses album gain for album queues and track gain for playlists, singles and shuffles. Playback settings also offer track gain, album gain, off and a preamp
+- Artist pages show an expandable biography, artwork from the server or built from the artist's albums, and separate sections for album credits and appearances
+- Sort lists can use regular names (the default), sort names, or sort names only for names without Latin letters
+- Improved handling for albums and tracks with multiple artists, including their names in song subtitles, the queue and info dialogs
+- Info dialogs in album and artist menus, listing credited artists, sort names and play and download details
+- Keep the screen on while now playing is open setting, off by default (thanks @chiangww!)
+
+## Fixed
+
+- Album and artist scroll positions survive navigating away and back
+- Search keeps its query and focus when you return
+- The library tab strip scrolls, so the settings gear is never squeezed out
+- Notification progress for streams of unknown length, such as Opus/Ogg transcodes
+- Album grid no longer shifts covers after a scrobble reloads the list
+- Now playing screen: artwork wraps with repeat, and cover shadows are no longer clipped
+
+## Performance
+
+- Faster library sync on servers without `search3`
+- Artist lists and downloads stay fast on large libraries
+
+**Full changelog:** https://github.com/austinried/subtracks/compare/v3.0.0...v3.1.0