diff --git a/doc/api.rst b/doc/api.rst
index ca016895..47bb42c3 100644
--- a/doc/api.rst
+++ b/doc/api.rst
@@ -237,6 +237,10 @@ You can also write a formatter for a hierarchy of classes::
     fmt::print("{}", a); // prints "B"
   }
 
+If a type provides both a ``formatter`` specialization and an implicit
+conversion to a formattable type, the specialization takes precedence over the
+conversion.
+
 .. doxygenclass:: fmt::basic_format_parse_context
    :members: