diff --git a/docs/static/java-codec.asciidoc b/docs/static/java-codec.asciidoc
index 45933ab18..a68fde22e 100644
--- a/docs/static/java-codec.asciidoc
+++ b/docs/static/java-codec.asciidoc
@@ -17,10 +17,14 @@
 //:methodheader: Logstash codecs must implement the `register` method, and the `decode` method or the `encode` method (or both).
 
 [[java-codec-plugin]]
+
 === How to write a Java codec plugin
 
 beta[]
 
+NOTE: Java codecs are currently supported only for Java input and output plugins. They will not work with Ruby
+input or output plugins.
+
 // Pulls in shared section: Setting Up Environment
 include::include/javapluginsetup.asciidoc[]