Tips and troubleshooting

• 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.

• Color changes don't persist: You must click Save in the Theme Management drawer. Reset and Cancel discard unsaved edits. If you saved but the palette reverted, check that the backend API for theme/palette update succeeded (e.g. no 4xx/5xx). 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