diff --git a/docs/docs/json.md b/docs/docs/json.md
index c9323b55661..28712fdd42b 100644
--- a/docs/docs/json.md
+++ b/docs/docs/json.md
@@ -44,6 +44,12 @@ import org.http4s.dsl.io._
 import org.http4s.implicits._
 ```
 
+@:callout(info)
+
+Under some setup options (we saw this in Scala 3.1.2 but not in 3.1.0), running `import io.circe._` might give you an error of `-- [E008] Not Found Error: value circe is not a member of io`. This means that `io` is shadowed from some other package. In that case, you should run `import _root_.io.circe._`, analogously for the other `circe` imports.
+
+@:@
+
 Then the actual code:
 
 ```scala mdoc