diff --git a/src/docs/markdown/metrics.md b/src/docs/markdown/metrics.md
index 75fb442..c5a22b2 100644
--- a/src/docs/markdown/metrics.md
+++ b/src/docs/markdown/metrics.md
@@ -13,6 +13,9 @@ In other words, you're going to want to be able to _monitor_ Caddy.
 
 You'll need to turn metrics on. If using a Caddyfile, enable metrics [in global options](/docs/caddyfile/options#metrics):
 
+> **Note**
+> Caddy 2.6 made metrics opt-in. To enable them, use either [Caddyfile global options](https://caddyserver.com/docs/caddyfile/options#metrics) or [the `metrics` parameter](https://caddyserver.com/docs/json/apps/http/servers/metrics/) of a server's JSON config.
+
 ```caddy
 {
     servers {