diff --git a/docs/release-notes.md b/docs/release-notes.md
index 8f1d600..560b7b9 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,5 +1,18 @@
 # Release Notes
 
+## v0.2.9
+
+Highlights:
+
+- Fixed a D3D12 editor crash where an instanced dynamic mesh shader expected `InstanceVF` but received a scene uniform buffer.
+- Aligned the custom instanced dynamic mesh vertex factory with UE GPUScene behavior for UE 5.5, 5.6, 5.7, and 5.8.
+- Rebuilt release packages to avoid stale plugin binaries or shader metadata.
+
+Packaging notes:
+
+- Regenerate marketplace project files from v0.2.9 or newer before upload.
+- Users upgrading from v0.2.8 should let Unreal recompile shaders after the plugin update.
+
 ## v0.2.8
 
 Highlights: