diff --git a/proto/caosdb/entity/v1/main.proto b/proto/caosdb/entity/v1/main.proto
index 6893d314ba74b969ce35f25c5c2f9b9716014726..11fd82a5361187f76abf0c8adb44cfd162270d85 100644
--- a/proto/caosdb/entity/v1/main.proto
+++ b/proto/caosdb/entity/v1/main.proto
@@ -540,7 +540,9 @@ message FindQueryResult {
 
 // A single result row of a SELECT query
 message SelectQueryRow {
-  // The cells of the table row contain the value of the SELECT'ed fields.
+  // The cells of the table row contain the value of the SELECT'ed fields. The
+  // order of the cells follows the order of the columns of the
+  // SelectQueryHeader.
   repeated Value cells = 2;
 }
 
@@ -552,6 +554,8 @@ message SelectQueryColumn {
 
 // The header line of the result of a SELECT query
 message SelectQueryHeader {
+  // List of columns in this table. The order defines the order of the cells in
+  // each of the SelectQueryRows.
   repeated SelectQueryColumn columns = 1;
 }