diff --git a/docs/changelog.md b/docs/changelog.md
index cfb27ce2..8267b366 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -2,15 +2,24 @@
 
 Release notes for `quimb`.
 
-(whats-new-1-8-2)=
+(whats-new-1-8-4)=
+## v1.8.4 (2024-07-20)
+
+**Bug fixes:**
+
+- fix for MPS sampling with fixed seed ({issue}`247` and {pull}`248`)
+- fix for `mps_gate_with_mpo_lazy` ({issue}`246`).
+
+
+(whats-new-1-8-3)=
 ## v1.8.3 (2024-07-10)
 
 **Enhancements:**
 
 - support for numpy v2.0 and scipy v1.14
 - add MPS sampling: [`MatrixProductState.sample_configuration`](quimb.tensor.tensor_1d.MatrixProductState.sample_configuration) and [`MatrixProductState.sample`](quimb.tensor.tensor_1d.MatrixProductState.sample) (generating multiple samples) and use these for [`CircuitMPS.sample`](quimb.tensor.circuit.CircuitMPS.sample) and [`CircuitPermMPS.sample`](quimb.tensor.circuit.CircuitPermMPS.sample).
-- add basic plot method for SimpleUpdate classes
-- add [`edges_1d_chain`](qumib.tensor.geometry.edges_1d_chain) for generating 1D chain edges
+- add basic [`.plot()`](quimb.tensor.tensor_arbgeom_tebd.TEBDGen.plot) method for SimpleUpdate classes
+- add [`edges_1d_chain`](quimb.tensor.geometry.edges_1d_chain) for generating 1D chain edges
 - [operatorbuilder](quimb.experimental.operatorbuilder): better coefficient placement for long range MPO building