diff --git a/paper-api/src/main/java/org/bukkit/block/Banner.java b/paper-api/src/main/java/org/bukkit/block/Banner.java
index cabf4744e..0ce851dd6 100644
--- a/paper-api/src/main/java/org/bukkit/block/Banner.java
+++ b/paper-api/src/main/java/org/bukkit/block/Banner.java
@@ -18,7 +18,9 @@ public interface Banner extends BlockState {
     DyeColor getBaseColor();
 
     /**
-     * Sets the base color for this banner
+     * Sets the base color for this banner.
+     * <b>Only valid for shield pseudo banners, otherwise base depends on block
+     * type</b>
      *
      * @param color the base color
      */