diff --git a/doc/source/pre/whatsnew/1.4.rst b/doc/source/pre/whatsnew/1.4.rst
index c3c4168d536eaf1c02dc572a2b03ac46bdab74a4..a0ea8521b4687fa8161757a3c45b723964f941b0 100644
--- a/doc/source/pre/whatsnew/1.4.rst
+++ b/doc/source/pre/whatsnew/1.4.rst
@@ -23,7 +23,7 @@ which calculates the Peierls phases for you::
 
   syst = make_system(hopping)
   lead = make_lead(hopping)
-  lead.substitute(peierls='peierls_lead')
+  lead.substituted(peierls='peierls_lead')
   syst.attach_lead(lead)
   syst = syst.finalized()
 
diff --git a/kwant/physics/gauge.py b/kwant/physics/gauge.py
index 0a0561f7f565548d9aa61a20e6180d918579794e..1fb80cfa1e3538f6f5ca151abb11a38c147ebb09 100644
--- a/kwant/physics/gauge.py
+++ b/kwant/physics/gauge.py
@@ -959,7 +959,7 @@ class magnetic_gauge:
     >>>
     >>> syst = make_system(hopping)
     >>> lead = make_lead(hopping)
-    >>> lead.substitute(peierls='peierls_lead')
+    >>> lead.substituted(peierls='peierls_lead')
     >>> syst.attach_lead(lead)
     >>> syst = syst.finalized()
     >>>