diff --git a/README.md b/README.md
index f48b91c27..d422adb0f 100644
--- a/README.md
+++ b/README.md
@@ -44,6 +44,10 @@ https://github.com/user-attachments/assets/72c6d6dc-48b0-48a0-bd8b-c7e70990edc4
 
 ---
 
+With the release of `v3.0.0` we introduced a small breaking change. This is solely for niri users, we reworked how we handle the wallpaper / overview. Please read [the docs](https://docs.noctalia.dev/getting-started/compositor-settings/#niri-wallpaper-and-overview-setup) to adapt your niri config.
+
+---
+
 ## 🚀 Getting Started
 
 **New to Noctalia?**