diff --git a/changes/ce/feat-12940.en.md b/changes/ce/feat-12940.en.md
new file mode 100644
index 000000000..24bdcc4e2
--- /dev/null
+++ b/changes/ce/feat-12940.en.md
@@ -0,0 +1,12 @@
+Add `ignore_readonly` argument to `PUT /configs` API.
+
+Prior to this change, EMQX would retrun 400 (BAD_REQUEST) if the raw config
+included readonly root keys (`cluster`, `rpc`, and `node`).
+
+After this enhancement it can be called as `PUT /configs?ignore_readonly=true`,
+EMQX will in this case ignore readonly root config keys, and apply the rest.
+
+A warning message is logged to warn that the readonly keys are dropped.
+
+Also fixed an exception when config has bad HOCON syntax (returns 500).
+Now bad syntax will cause the API to return 400 (BAD_REQUEST).
diff --git a/changes/ce/fix-12940.en.md b/changes/ce/fix-12940.en.md
deleted file mode 100644
index 8304effd5..000000000
--- a/changes/ce/fix-12940.en.md
+++ /dev/null
@@ -1,3 +0,0 @@
-Fix config update API `/configs` 500 error when config has bad HOCON syntax.
-
-Now bad syntax will cause the API to return 400 (BAD_REQUEST).