diff --git a/doc/reference/views.rst b/doc/reference/views.rst
index 4622716ff7e..054cfbf0be8 100644
--- a/doc/reference/views.rst
+++ b/doc/reference/views.rst
@@ -234,6 +234,11 @@ Possible children elements of the list view are:
 
         Makes the button ``invisible`` if the record is *not* in one of the
         listed states
+
+        .. danger::
+
+            Using ``states`` in combination with ``attrs`` may lead to
+            unexpected results as domains are combined with a logical AND.
     ``context``
         merged into the view's context when performing the button's Odoo call
     ``confirm``