diff --git a/channels/text.proto b/channels/text.proto
index 0abb7e6167a4b247fdfc930e22d1393cc098df79..97a34c745697a3315facebe1ab0b4da94bef11ee 100644
--- a/channels/text.proto
+++ b/channels/text.proto
@@ -10,12 +10,17 @@ syntax = "proto3";
 package parse;
 option go_package = "/channels";
 
+// CMIXChannelText is the payload for sending normal text messages to channels
+// the replyMessageID is nil when it is not a reply
 message CMIXChannelText {
   uint32 version = 1;
   string text = 2;
   bytes replyMessageID = 3;
 }
 
+// CMIXChannelReaction is the payload for reactions. The reaction must be a
+// single emoji and the reactionMessageID must be non nil and a real message
+// in the channel
 message CMIXChannelReaction {
   uint32 version = 1;
   string reaction = 2;