diff --git a/apps/gittensory-ui/src/components/site/app-panels/maintainer-settings.tsx b/apps/gittensory-ui/src/components/site/app-panels/maintainer-settings.tsx
index 00f24589f8..dc91833ea9 100644
--- a/apps/gittensory-ui/src/components/site/app-panels/maintainer-settings.tsx
+++ b/apps/gittensory-ui/src/components/site/app-panels/maintainer-settings.tsx
@@ -422,6 +422,7 @@ export function MaintainerSettings({ reviewability }: { reviewability: Array<{ p
             <div className="mt-2 grid gap-4 sm:grid-cols-2 lg:grid-cols-3">
               <ToggleControl
                 label="Auto-label PRs"
+                hint="Only the base context label below — type labels have their own toggle"
                 value={settings.autoLabelEnabled}
                 onChange={(v) => setField("autoLabelEnabled", v)}
               />
diff --git a/src/types.ts b/src/types.ts
index 4ed89ad4ae..db85ec3a2b 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -909,6 +909,10 @@ export type RepositorySettings = {
    *  PRs are exempt from auto-close (merge or manual-hold only). Per-repo configurable so maintainers choose
    *  rather than inheriting a hardwired opinion. */
   closeOwnerAuthors: boolean;
+  /** #label-decoupling: gates ONLY the base {@link gittensorLabel} context label (`shouldApplyPrLabel`/
+   *  `willLabel` in `signals/settings-preview.ts`) -- zero effect on TYPE/taxonomy labels
+   *  ({@link typeLabelsEnabled}), moderation/blacklist labels, or review-state labels. Four independent
+   *  label families exist; none of them gates or silently disables another. */
   autoLabelEnabled: boolean;
   gittensorLabel: string;
   createMissingLabel: boolean;