diff --git a/py-polars/polars/io/pyarrow_dataset/functions.py b/py-polars/polars/io/pyarrow_dataset/functions.py
index 81a5f1a51bc2..339cb270c0a2 100644
--- a/py-polars/polars/io/pyarrow_dataset/functions.py
+++ b/py-polars/polars/io/pyarrow_dataset/functions.py
@@ -20,6 +20,13 @@ def scan_pyarrow_dataset(
 
     This can be useful to connect to cloud or partitioned datasets.
 
+    .. warning::
+
+        This method can only can push down predicates that are allowed by PyArrow
+        (e.g. not the full Polars API).
+
+        If :func:`scan_parquet` works for your source, you should use that instead.
+
     Parameters
     ----------
     source