diff --git a/src/types/role.ts b/src/types/role.ts
index da51cde2f..aaae41b90 100644
--- a/src/types/role.ts
+++ b/src/types/role.ts
@@ -20,7 +20,10 @@ export interface RoleData {
 }
 
 export interface RoleTags {
+  /** the id of the bot who has this role */
   bot_id?: string;
+  /** whether this is the premium subscriber role for this guild */
   premium_subscriber?: null;
+  /** the id of the integration this role belongs to */
   integration_id?: string;
 }