diff --git a/Cargo.lock b/Cargo.lock
index 2eea6759..c855c038 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -76,7 +76,7 @@ dependencies = [
 
 [[package]]
 name = "bon"
-version = "3.0.2"
+version = "3.1.0"
 dependencies = [
  "bon-macros",
  "expect-test",
@@ -97,7 +97,7 @@ dependencies = [
 
 [[package]]
 name = "bon-macros"
-version = "3.0.2"
+version = "3.1.0"
 dependencies = [
  "darling",
  "expect-test",
@@ -111,7 +111,7 @@ dependencies = [
 
 [[package]]
 name = "bon-sandbox"
-version = "3.0.2"
+version = "3.1.0"
 dependencies = [
  "bon",
  "buildstructor",
diff --git a/README.md b/README.md
index 694a755d..25cdb15d 100644
--- a/README.md
+++ b/README.md
@@ -203,7 +203,7 @@ Add `bon` to your `Cargo.toml`.
 
 ```toml
 [dependencies]
-bon = "3.0"
+bon = "3.1"
 ```
 
 You can opt out of `std` and `alloc` cargo features with `default-features = false` for `no_std` environments.
diff --git a/bon-macros/Cargo.toml b/bon-macros/Cargo.toml
index a0a21efb..3d74dd3f 100644
--- a/bon-macros/Cargo.toml
+++ b/bon-macros/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name    = "bon-macros"
-version = "3.0.2"
+version = "3.1.0"
 
 description = """
 This is a proc-macro crate that is supposed to be a private implementation
diff --git a/bon-sandbox/Cargo.toml b/bon-sandbox/Cargo.toml
index 87fce198..14083e92 100644
--- a/bon-sandbox/Cargo.toml
+++ b/bon-sandbox/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name    = "bon-sandbox"
-version = "3.0.2"
+version = "3.1.0"
 
 description = """
   Not a real crate! It's just a showcase of examples used by `bon`'s documentation
@@ -29,7 +29,7 @@ targets = ["x86_64-unknown-linux-gnu"]
 workspace = true
 
 [dependencies]
-bon            = { path = "../bon", version = "=3.0.2", features = ["experimental-overwritable"] }
+bon            = { path = "../bon", version = "=3.1.0", features = ["experimental-overwritable"] }
 buildstructor  = "0.5"
 derive_builder = "0.20"
 typed-builder  = "0.20"
diff --git a/bon/Cargo.toml b/bon/Cargo.toml
index 3e1d488f..b7ad30ad 100644
--- a/bon/Cargo.toml
+++ b/bon/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name    = "bon"
-version = "3.0.2"
+version = "3.1.0"
 
 description = "Next-gen compile-time-checked builder generator, named function's arguments, and more!"
 
@@ -45,7 +45,7 @@ workspace = true
 # The version of the macro crate is pinned to a specific one because the code
 # generated by the macros uses private APIs from the runtime crate that are not
 # guarded by semver.
-bon-macros  = { path = "../bon-macros", version = "=3.0.2" }
+bon-macros  = { path = "../bon-macros", version = "=3.1.0" }
 rustversion = "1"
 
 [dev-dependencies]
diff --git a/website/src/changelog.md b/website/src/changelog.md
index 13676c63..8cf1ff3b 100644
--- a/website/src/changelog.md
+++ b/website/src/changelog.md
@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.1.0](https://github.com/elastio/bon/compare/v3.0.2...v3.1.0) - 2024-11-24
+
+### Added
+
+-   Add [`#[builder(field)]`](https://bon-rs.com/reference/builder/member/field) to define custom private fields on the builder type. See [Custom Fields](https://bon-rs.com/guide/typestate-api/custom-fields) guide for details ([#207](https://github.com/elastio/bon/pull/207))
+
+### Other
+
+-   Internal refactoring of naming in `bon`s test suite ([#215](https://github.com/elastio/bon/pull/215))
+
 ## [3.0.2](https://github.com/elastio/bon/compare/v3.0.1...v3.0.2) - 2024-11-20
 
 ### Fixed
diff --git a/website/src/guide/typestate-api/custom-methods.md b/website/src/guide/typestate-api/custom-methods.md
index 3a4b3e4e..5f1f3345 100644
--- a/website/src/guide/typestate-api/custom-methods.md
+++ b/website/src/guide/typestate-api/custom-methods.md
@@ -293,5 +293,5 @@ This is implemented as a cargo feature to make sure `bon` maintains a lower MSRV
 
 ```toml
 [dependencies]
-bon = { version = "3.0", features = ["implied-bounds"] }
+bon = { version = "3.1", features = ["implied-bounds"] }
 ```