diff --git a/docs/api/wrapper/contains.md b/docs/api/wrapper/contains.md
index c56d39ac3..301981ca7 100644
--- a/docs/api/wrapper/contains.md
+++ b/docs/api/wrapper/contains.md
@@ -1,5 +1,9 @@
 ## contains
 
+::: warning Deprecation warning
+Using `contains` is deprecated and will be removed in future releases. Use [`find`](./find.md) for DOM nodes (using `querySelector` syntax), [`findComponent`](./findComponent.md) for components, or [`wrapper.get`](./get.md) instead.
+:::
+
 Assert `Wrapper` contains an element or component matching [selector](../selectors.md).
 
 - **Arguments:**