diff --git a/mintlify/changelog/bytebase-3-12-0.mdx b/mintlify/changelog/bytebase-3-12-0.mdx
new file mode 100644
index 00000000..098aae86
--- /dev/null
+++ b/mintlify/changelog/bytebase-3-12-0.mdx
@@ -0,0 +1,76 @@
+---
+title: Bytebase 3.12.0 - Nov 6, 2025
+author: Adela
+updated_at: 2025/11/6 18:00:00
+description: 'PostgreSQL - State-based GitOps workflow'
+---
+
+import InstallUpgrade from '/snippets/install/install-upgrade.mdx';
+
+## 🚀 Features
+
+- Add [State-based GitOps workflow](/gitops/state-based-workflow/overview) for PostgreSQL.
+- Add support for [IdP-initiated SSO flow](/administration/sso/idp-initiated).
+
+## 🔔 Notable Changes
+
+- Remove identity provider permissions from the Workspace DBA role.
+- Remove support for URL-based secret retrieval via `URL` template format.
+- Deprecate changelist feature.
+- Add character length limits to prevent overly long entries and ensure data consistency. Length limits applied:
+  - 200 characters: Titles and names (groups, issues, plans, projects, instances, users, etc.)
+  - 1,000 characters: Short descriptions (group descriptions, operation reasons for cancel/skip/restart tasks)
+  - 10,000 characters: Long descriptions (issue details, plan details)
+  - 65,536 characters: Comments and long-form text (issue comments)
+- Update `APP_IM` configuration format in API and UI.
+
+    Before:
+    ```json
+    {
+    "slack": {
+        "enabled": true,
+        "token": "xxx"
+    },
+    "lark": {
+        "enabled": true,
+        ...
+    },
+    "feishu": {
+        "enabled": true,
+        ...
+    }
+    }
+    ```
+
+    After:
+    ```json
+    {
+    "settings": [
+        {
+        "type": "slack",
+        "slack": {
+            "token": "xxx"
+        }
+        },
+        {
+        "type": "lark",
+        "lark": {}
+        }
+    ]
+    }
+    ```
+
+## 🎄 Enhancements
+
+- Issue comment editor now supports searching and linking to other issues within the same project.
+- Support data export for multi-statement queries in SQL Editor.
+- Enhance SSO state management to align with OAuth 2.0 best practices.
+- Add 5-minute expiration for MFA temporary tokens.
+- Clarify label types with explicit naming: Project Labels, Issue Labels, Database Labels.
+
+## 🐞 Bug Fixes
+
+- Fix the role selector reverting SQL edits during edit mode when the issue poller runs.
+- Fix the false positive `Primary Key missing` error during SQL Review when adding a PK in a separate statement for PostgreSQL.
+
+<InstallUpgrade />
diff --git a/mintlify/docs.json b/mintlify/docs.json
index 6587d7d2..c50e7f72 100644
--- a/mintlify/docs.json
+++ b/mintlify/docs.json
@@ -379,6 +379,7 @@
       {
         "tab": "Changelog",
         "pages": [
+          "changelog/bytebase-3-12-0",
           "changelog/bytebase-3-11-1",
           "changelog/bytebase-3-11-0",
           "changelog/bytebase-3-10-1",