Brand name or logos don't update: After clicking Save Settings, check for a success toast. If the request fails, an error toast appears. Ensure you have permission to change appearance settings. If the sidebar still shows the old value, refresh the page once; the backend is the source of truth and the next load will use the saved data.
Drawer doesn't open: Ensure you're clicking the Theme or Palette card on the Appearance page (or using the user menu entry). If the drawer is implemented as a lazy-loaded component, a brief delay is normal. Check the browser console for errors.
Unsaved badge keeps showing: The Unsaved label appears only while the palette editor is open and you have edits that are not saved yet. Click Save in the drawer footer, or Reset / Cancel to discard. Closing the palette modal without saving may leave the drawer in an unsaved state until you choose an action.
Palette editor feels cramped: Recent versions use a flatter layout without nested cards. Scroll within the palette panel if you have many color groups. Switch light / dark to edit the other mode.
Color changes don't persist: Click Save in the Theme Management drawer. Reset and Cancel discard unsaved edits. If you saved but the palette reverted, reload the page to see the last saved state.
Live preview not updating: The drawer applies edits to the app theme in memory; if an iframe or another window doesn't update, it may be on a different origin or the sync event may not be reaching it. Try toggling light/dark once or closing and reopening the drawer to force a refresh.
Only one theme appears: The product may ship with one active theme (e.g. "Starter" or "Modern"); theme selection UI may be simplified or reworked in a future version. You can still create and edit palettes for that theme and switch between light and dark.
"Bundled" vs "Custom": Bundled palettes come with the theme and may have limited editing (or be merged with presets). Custom palettes are fully editable. Synced means the palette is tied to a WordPress theme key. Use custom palettes for full control over your brand colors.
Quick reference
| Topic | Details |
Appearance | #/settings/appearance: Brand name, light logo, dark logo, Theme & Palette summary, Save Settings. |
Theme Management | Drawer opened from Appearance (click theme/palette card) or user menu; no direct URL. |
Brand | Brand name in sidebar header; light/dark logos applied globally after save. |
Palettes | Per-theme; modes light/dark; create, edit, save, reset; live preview. |
APIs | GET/POST .../settings/appearance; themes API (list, get); palettes (list, create, update, delete); active theme settings. |
Save | Appearance: "Save Settings"; Drawer: "Save" for theme/palette changes. |