diff --git a/docs/en/12-taos-sql/03-table.md b/docs/en/12-taos-sql/03-table.md
index 10c44848c9..b84c17bfac 100644
--- a/docs/en/12-taos-sql/03-table.md
+++ b/docs/en/12-taos-sql/03-table.md
@@ -91,12 +91,15 @@ ALTER TABLE [db_name.]tb_name alter_table_clause
 
 alter_table_clause: {
     alter_table_options
-  | ADD COLUMN col_name column_type
+  | ADD COLUMN col_name column_definition
   | DROP COLUMN col_name
-  | MODIFY COLUMN col_name column_type
+  | MODIFY COLUMN col_name column_definition
   | RENAME COLUMN old_col_name new_col_name
 }
 
+column_definition:
+    type_name [comment 'string_value']
+
 alter_table_options:
     alter_table_option ...
 
diff --git a/docs/zh/12-taos-sql/03-table.md b/docs/zh/12-taos-sql/03-table.md
index 9258258263..f5540aeb63 100644
--- a/docs/zh/12-taos-sql/03-table.md
+++ b/docs/zh/12-taos-sql/03-table.md
@@ -23,7 +23,10 @@ create_subtable_clause: {
 }
 
 create_definition:
-    col_name column_type
+    col_name column_definition
+
+column_definition:
+    type_name [comment 'string_value']
 
 table_options:
     table_option ...
@@ -89,12 +92,15 @@ ALTER TABLE [db_name.]tb_name alter_table_clause
 
 alter_table_clause: {
     alter_table_options
-  | ADD COLUMN col_name column_type
+  | ADD COLUMN col_name column_definition
   | DROP COLUMN col_name
-  | MODIFY COLUMN col_name column_type
+  | MODIFY COLUMN col_name column_definition
   | RENAME COLUMN old_col_name new_col_name
 }
 
+column_definition:
+    type_name [comment 'string_value']
+
 alter_table_options:
     alter_table_option ...