diff --git a/docs/conf.py b/docs/conf.py
index 1d0cf20e954f..d9ba8e2eff91 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -121,6 +121,14 @@
 napoleon_numpy_docstring = False
 
 
+# Autosummary generates stub filenames based on the import name.
+# Sometimes, two distinct interfaces only differ in capitalization; this
+# creates a problem on case-insensitive OS/filesystems like macOS. So,
+# we manually avoid the clash by renaming one of the files.
+autosummary_filename_map = {
+    "qiskit.circuit.library.iqp": "qiskit.circuit.library.iqp_function",
+}
+
 # ----------------------------------------------------------------------------------
 # Doctest
 # ----------------------------------------------------------------------------------