Skip to main content

Themes and Settings

Customize your Admin Panel experience with user-scoped themes and settings. Your preferences are stored per user and persist across sessions.

Prerequisites​

  • A logged-in Admin Panel session (Discord OAuth or local auth).

Settings Page​

Open the user dropdown in the top-right corner of the Admin Panel and select Settings. From there you can:

SettingDescription
Display NameYour display name shown in the admin UI.
Active ThemeThe AdminJS theme applied to your session.

Themes​

Themes control the look and feel of the Admin Panel — colors, spacing, typography, and other design tokens. Theme colors apply universally (sidebar, header, main content). All text, buttons, inputs, and labels use theme-aware colors that automatically adapt for readability across light and dark themes. Ledgerline supports:

  • System themes — Built-in themes (e.g. default dark/light) available to all users.
  • Custom themes — Themes you create, which can extend a base theme and override specific tokens.

Applying a Theme​

  1. Open the user dropdown (top-right) → Settings.
  2. Under System Themes or Your Custom Themes, select a theme.
  3. The page reloads automatically to apply the new theme.

Your theme choice is saved immediately and persists for your next login. Section blocks use a distinct background for visual hierarchy, and text uses high-contrast colors for readability on dark themes.

Creating a Custom Theme​

  1. Open Settings (user dropdown).
  2. In Copy a Theme, enter a name and click Copy Current Theme to duplicate your active theme.
  3. Enter a name and optionally choose a base theme to extend.
  4. Adjust overrides (colors, spacing, etc.) as needed.
  5. Click Save.

Custom themes are owned by your user and only visible to you.

Copying a Theme​

To build on an existing theme:

  1. In Settings, select the theme you want to copy (under System or Custom themes).
  2. In Copy a Theme, enter a new name and click Copy Current Theme.
  3. The new theme appears under Your Custom Themes and can be selected.

This creates a copy owned by you, which you can modify without affecting the original.

Deleting a Custom Theme​

You can only delete themes you own. System themes cannot be deleted.

  1. Open Settings (user dropdown).
  2. Find your custom theme under Your Custom Themes and click the ✕ button.
  3. Confirm deletion.

If the deleted theme was your active theme, the UI falls back to the default theme.

API Access​

Settings and themes are also available via REST API for integrations. See User Settings API for endpoints and schemas.

Last updated on by renovate[bot]