diff --git a/res/themes/light-custom/css/_custom.scss b/res/themes/light-custom/css/_custom.scss
index 38cc33b3c9..48ffcc13ce 100644
--- a/res/themes/light-custom/css/_custom.scss
+++ b/res/themes/light-custom/css/_custom.scss
@@ -1,4 +1,5 @@
-// accent color
+//
+// PALETTE COLOR: accent color
 $accent-color: var(--accent-color);
 $button-bg-color: var(--accent-color);
 $button-link-fg-color: var(--accent-color);
@@ -9,8 +10,9 @@ $roomsublist-chevron-color: var(--accent-color);
 $tab-label-active-bg-color: var(--accent-color);
 $togglesw-on-color: var(--accent-color);
 $username-variant3-color: var(--accent-color);
-// background color
 $accent-color-50pct: var(--accent-color-50pct); //still needs alpha at .5
+//
+// PALETTE COLOR: background color
 $authpage-body-bg-color: var(--background-color);
 $avatar-bg-color: var(--background-color);
 $button-secondary-bg-color: var(--background-color);
@@ -22,13 +24,15 @@ $primary-bg-color: var(--background-color);
 $roomtile-focused-bg-color: var(--background-color);
 $roomtile-selected-bg-color: var(--background-color);
 $togglesw-ball-color: var(--background-color);
-// base color
 $droptarget-bg-color: var(--background-color-50pct); //still needs alpha at .5
 $authpage-modal-bg-color: var(--background-color-50pct); //still needs alpha at .59
+//
+// PALETTE COLOR: base color
 $interactive-tooltip-bg-color: var(--base-color);
 $tagpanel-bg-color: var(--base-color);
 $tooltip-timeline-bg-color: var(--base-color);
-// panel color
+//
+// PALETTE COLOR: panel color
 $event-selected-color: var(--panel-color);
 $header-panel-bg-color: var(--panel-color);
 $reaction-row-button-bg-color: var(--panel-color);
@@ -41,15 +45,18 @@ $roomsublist-background: var(--panel-color);
 $secondary-accent-color: var(--panel-color);
 $selected-color: var(--panel-color);
 $widget-menu-bar-bg-color: var(--panel-color);
-// panel contrast color
+//
+// PALETTE COLOR: panel contrast color
 $input-darker-bg-color: var(--panel-contrast-color);
 $panel-divider-color: var(--panel-contrast-color);// originally #dee1f3, not #e3e8f0, but close enough
-// body text color
+//
+// PALETTE COLOR: body text color
 $message-action-bar-fg-color: var(--body-text-color);
 $primary-fg-color: var(--body-text-color);
 $settings-profile-overlay-placeholder-fg-color: var(--body-text-color);
-// body contrast color
 $dialog-backdrop-color: var(--body-text-color-50pct); //still needs alpha at .38
+//
+// PALETTE COLOR: body contrast color
 $authpage-secondary-color: var(--body-contrast-color);
 $memberstatus-placeholder-color: var(--body-contrast-color);
 $notice-secondary-color: var(--body-contrast-color);
@@ -57,10 +64,12 @@ $pinned-color: var(--body-contrast-color);
 $roomsublist-label-fg-color: var(--body-contrast-color);
 $roomtile-name-color: var(--body-contrast-color);
 $settings-subsection-fg-color: var(--body-contrast-color);
-// primary color
+//
+// PALETTE COLOR: primary color
 $accent-color-alt: var(--primary-color);
 $input-focused-border-color: var(--primary-color);
-// warning color
+//
+// PALETTE COLOR: warning color
 $button-danger-bg-color: var(--warning-color);
 $event-highlight-fg-color: var(--warning-color);
 $input-invalid-border-color: var(--warning-color);