diff --git a/mintlify/administration/custom-approval.mdx b/mintlify/administration/custom-approval.mdx
index 2667e641a..8901a01a5 100644
--- a/mintlify/administration/custom-approval.mdx
+++ b/mintlify/administration/custom-approval.mdx
@@ -16,7 +16,7 @@ Custom Approval allows you to create multi-stage approval workflows based on cha
**Best Practices:**
- Custom Approval works best with [UI workflow](/change-database/change-workflow/#ui-workflow). For [GitOps workflow](/change-database/change-workflow/#gitops-workflow), configure approvals in your PR/MR process instead.
-- By default, users cannot self-approve their own issues. You can [change this setting](/change-database/issue/#self-approval) in project settings if needed.
+- By default, users cannot self-approve their own issues. You can [change this setting](/change-database/settings#self-approval) in project settings if needed.
## How It Works
diff --git a/mintlify/change-database/issue.mdx b/mintlify/change-database/issue.mdx
deleted file mode 100644
index d56802b18..000000000
--- a/mintlify/change-database/issue.mdx
+++ /dev/null
@@ -1,23 +0,0 @@
----
-title: Issue
----
-
-**Issue** drives the database change workflow. You can change the issue behavior under the **Issue Related** section of **Project** -> **Setting**.
-
-## Postgres database tenant mode
-
-
-
-By default, Bytebase executes database changes using the credentials configured in your Bytebase workspace.
-
-When you enable this setting, Bytebase automatically switches to the target PostgreSQL database's OWNER role (via `SET LOCAL ROLE`) before executing changes.
-
-This feature is particularly valuable for multi-tenant environments where each database has its own distinct owner, ensuring changes are always executed with appropriate permissions.
-
-## Self approval
-
-Issue creators themselves are not allowed to approve the issue by default.
-
-To allow self approval, check the **Allow self approval** option box under the **Issue Related** section of **Setting** in a certain project.
-
-
\ No newline at end of file
diff --git a/mintlify/change-database/settings.mdx b/mintlify/change-database/settings.mdx
new file mode 100644
index 000000000..e617fcf0b
--- /dev/null
+++ b/mintlify/change-database/settings.mdx
@@ -0,0 +1,36 @@
+---
+title: Settings
+---
+
+Customize how database changes work in your projects. Navigate to **Project** → **Settings** to access these options.
+
+## Transaction Mode
+
+
+Supported databases: MySQL, PostgreSQL, Oracle, SQL Server, TiDB, Redshift
+
+
+By default, Bytebase wraps SQL statements in a transaction for safety - if something goes wrong, changes can be rolled back.
+
+Some DDL statements can't run inside transactions. To disable transaction wrapping, add this comment before your SQL:
+
+```sql
+-- txn-mode=off
+ALTER TABLE t ALTER COLUMN a TYPE VARCHAR(255);
+```
+
+## Postgres Tenant Mode
+
+Perfect for multi-tenant PostgreSQL setups where each database has its own owner.
+
+When enabled, Bytebase automatically switches to the database's OWNER role before executing changes, ensuring proper permissions.
+
+**Location:** Project → Settings → Issue Related
+
+## Self Approval
+
+By default, issue creators can't approve their own changes.
+
+To allow self-approval, enable **Allow self approval** in your project settings.
+
+**Location:** Project → Settings → Issue Related
\ No newline at end of file
diff --git a/mintlify/change-database/transaction-mode.mdx b/mintlify/change-database/transaction-mode.mdx
deleted file mode 100644
index 6d8fd6ba1..000000000
--- a/mintlify/change-database/transaction-mode.mdx
+++ /dev/null
@@ -1,18 +0,0 @@
----
-title: Transaction Mode
----
-
-
-
-Transaction mode is supported in MySQL, PostgreSQL, Oracle, SQL Server, TiDB, Redshift.
-
-
-
-Bytebase wraps all SQL statements in a transaction by default. This ensures that changes are atomic and can be rolled back if an error occurs, providing a safeguard for database integrity.
-
-However, there are scenarios where you might want to disable transaction wrapping. For example, certain DDL (Data Definition Language) statements, such as altering table structures, may not be compatible with transactions in some databases. In such cases, you can disable transaction wrapping using the directive `-- txn-mode=off`.
-
-```sql
--- txn-mode=off
-ALTER TABLE t ALTER COLUMN a TYPE VARCHAR(255);
-```
diff --git a/mintlify/change-database/troubleshoot.mdx b/mintlify/change-database/troubleshoot.mdx
index 2b55c6a13..32f83bed9 100644
--- a/mintlify/change-database/troubleshoot.mdx
+++ b/mintlify/change-database/troubleshoot.mdx
@@ -26,7 +26,7 @@ Following permission errors are likely to happen if either conditions meet:
### ERROR: permission denied to set role xxx (SQLSTATE 42501)
-This could happen if you turn on [Postgres database tenant mode](/change-database/issue/#postgres-database-tenant-mode).
+This could happen if you turn on [Postgres database tenant mode](/change-database/settings#postgres-tenant-mode).
You need to grant the database owner permission to the Bytebase user configured in your PostgreSQL instance.
@@ -44,7 +44,7 @@ If you use AlloyDB, the database owner must NOT be created via [Cloud IAM](https
### ERROR: must be owner of table xxx (SQLSTATE 42501)
-This could happen if you turn on [Postgres database tenant mode](/change-database/issue/#postgres-database-tenant-mode).
+This could happen if you turn on [Postgres database tenant mode](/change-database/settings#postgres-tenant-mode).
For some sophisticated setup where database owner and table owner are different, this causes problem.
Because only table owner can alter that table schema, and if the database owner is not a member of
diff --git a/mintlify/docs.json b/mintlify/docs.json
index d0d0bccb0..a98e5bdae 100644
--- a/mintlify/docs.json
+++ b/mintlify/docs.json
@@ -97,6 +97,7 @@
"change-database/synchronize-schema",
"change-database/stored-procedure",
"change-database/schema-editor",
+ "change-database/schema-template",
"change-database/online-schema-migration-for-mysql"
]
},
@@ -133,16 +134,6 @@
"group": "Monitor",
"pages": ["change-database/drift-detection"]
},
- {
- "group": "Settings",
- "pages": [
- "change-database/webhook",
- "change-database/risk-center",
- "change-database/issue",
- "change-database/transaction-mode",
- "change-database/schema-template"
- ]
- },
"change-database/troubleshoot"
]
},
@@ -152,6 +143,14 @@
"gitops/overview",
"gitops/release"
]
+ },
+ {
+ "group": "General",
+ "pages": [
+ "change-database/webhook",
+ "change-database/risk-center",
+ "change-database/settings"
+ ]
}
]
},