diff --git a/CHANGELOG.md b/CHANGELOG.md
index de0d48b..d61d1d2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,22 @@ Notable changes to Iconoclast will be documented here. Breaking changes are mark
Iconoclast adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
+## [3.1.0] - 2024-11-22
+
+### Added
+
+- Iconoclast's new `uv` option, if set to `true`, will tell Iconoclast to prefer [uv](https://docs.astral.sh/uv)'s
+ [pip interface](https://docs.astral.sh/uv/pip/) over pip. If `uv` can't be found in your system path, Iconoclast
+ will fall back to pip.
+
+```yaml
+# mkdocs.yml
+
+plugins:
+ - iconoclast:
+ uv: true
+```
+
## [3.0.1] - 2024-11-22
### Fixed
diff --git a/pyproject.toml b/pyproject.toml
index eaed7e1..92e1d9f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[tool.poetry]
name = "iconoclast"
-version = "3.0.1"
+version = "3.1.0"
description = "Font Awesome Pro integration for Material for MkDocs"
authors = ["celsius narhwal "]
readme = "README.md"