diff --git a/src/docs/configuration/merging/README.md b/src/docs/configuration/merging/README.md
index 5c224fa91..b801f0785 100644
--- a/src/docs/configuration/merging/README.md
+++ b/src/docs/configuration/merging/README.md
@@ -176,6 +176,18 @@ tasks.named('shadowJar', com.github.jengelman.gradle.plugins.shadow.tasks.Shadow
 }
 ```
 
+## Merging Log4j2 Plugin Cache Files (`Log4j2Plugins.dat`)
+
+`Log4j2PluginsCacheFileTransformer` is a `Transformer` that merges `META-INF/org/apache/logging/log4j/core/config/plugins/Log4j2Plugins.dat` plugin caches from all the jars
+containing Log4j 2.x Core components. It's a Gradle equivalent of [Log4j Plugin Descriptor Transformer](https://logging.apache.org/log4j/transform/log4j-transform-maven-shade-plugin-extensions.html#log4j-plugin-cache-transformer).
+
+```groovy
+// Merging Log4j2 Plugin Cache Files
+tasks.named('shadowJar', com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar) {
+  transform(com.github.jengelman.gradle.plugins.shadow.transformers.Log4j2PluginsCacheFileTransformer.class)
+}
+```
+
 ## Appending Text Files
 
 Generic text files can be appended together using the