diff --git a/docs/source/user-guide/compatibility.md b/docs/source/user-guide/compatibility.md
index a16fd1b21..9791a169c 100644
--- a/docs/source/user-guide/compatibility.md
+++ b/docs/source/user-guide/compatibility.md
@@ -32,6 +32,13 @@ be used in production.
 
 There is an [epic](https://github.com/apache/datafusion-comet/issues/313) where we are tracking the work to fully implement ANSI support.
 
+## Regular Expressions
+
+Comet uses the [regex](https://crates.io/crates/regex) crate to evaluate regular expressions, and it is expected that
+this will produce different results to Java's regular expression engine in some cases. It also lacks support for
+features such as backreferences. For these reasons, regular expression support is disabled by default and can be
+enabled by setting `spark.comet.regexp.allowIncompatible=true`.
+
 ## Cast
 
 Cast operations in Comet fall into three levels of support:
diff --git a/docs/templates/compatibility-template.md b/docs/templates/compatibility-template.md
index 64f871354..9aecef1c8 100644
--- a/docs/templates/compatibility-template.md
+++ b/docs/templates/compatibility-template.md
@@ -32,6 +32,13 @@ be used in production.
 
 There is an [epic](https://github.com/apache/datafusion-comet/issues/313) where we are tracking the work to fully implement ANSI support.
 
+## Regular Expressions
+
+Comet uses the [regex](https://crates.io/crates/regex) crate to evaluate regular expressions, and it is expected that
+this will produce different results to Java's regular expression engine in some cases. It also lacks support for
+features such as backreferences. For these reasons, regular expression support is disabled by default and can be
+enabled by setting `spark.comet.regexp.allowIncompatible=true`.
+
 ## Cast
 
 Cast operations in Comet fall into three levels of support: