--- a/src/features/brand/components/guidelines/GuidelinesDocument.tsx
+++ b/src/features/brand/components/guidelines/GuidelinesDocument.tsx
@@ -162,8 +162,15 @@
     <div
       ref={editorBoxRef}
       className="rounded-2xl border border-hairline bg-canvas px-6 py-5"
     >
+      <p className="mb-3 text-xs text-ink/55">
+        {editable
+          ? canAddFiles
+            ? t("helpEditableWithUpload")
+            : t("helpEditableReferences")
+          : t("helpReadOnly")}
+      </p>
       <MarkdownMentionEditor
         value={value}
         onValueChange={onChange}
         suggestions={suggestions}

--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -3692,7 +3692,10 @@
       "editorPlaceholder": "Write the brand's rules and judgment here. Type @ to point at a logo, a typeface or an image.",
       "emptyLinePlaceholder": "Press / for commands, @ to mention a file…",
       "outlineLabel": "Contents",
-      "uploadFailed": "Couldn’t upload {name}"
+      "uploadFailed": "Couldn’t upload {name}",
+      "helpEditableWithUpload": "Use @ to reference existing logos, typefaces or example images; use /upload to add a file and insert its reference here.",
+      "helpEditableReferences": "Use @ to reference existing brand files. Adding new files requires upload permission.",
+      "helpReadOnly": "Read-only guidelines. You can still inspect references in this document."
     }
   },
   "landing": {

--- a/src/i18n/locales/vi.json
+++ b/src/i18n/locales/vi.json
@@ -3692,7 +3692,10 @@
       "editorPlaceholder": "Viết các quy tắc và nhận định của thương hiệu tại đây. Gõ @ để trỏ tới logo, phông chữ hoặc hình ảnh.",
       "emptyLinePlaceholder": "Nhấn / để mở lệnh, @ để nhắc tới tệp…",
       "outlineLabel": "Mục lục",
-      "uploadFailed": "Không tải lên được {name}"
+      "uploadFailed": "Không tải lên được {name}",
+      "helpEditableWithUpload": "Dùng @ để nhắc logo, font hoặc ảnh mẫu đã có; gõ /upload để thêm tư liệu và chèn tham chiếu ngay tại đây.",
+      "helpEditableReferences": "Dùng @ để nhắc tư liệu đã có. Thêm tư liệu mới cần quyền tải lên.",
+      "helpReadOnly": "Chế độ chỉ đọc. Bạn vẫn có thể xem các tham chiếu trong tài liệu."
     }
   },
   "landing": {