Skip to content

Settings Panel Reference

Settings Panel Reference

Press Ctrl+, (Cmd+,) or click the Gear Icon at the bottom of the sidebar to open the Settings Panel (SettingsModal.tsx). This reference documents every tab, dropdown, slider, checkbox, and action button available across the ten configuration sections.

1. General Settings Tab

Controls appearance, language, audio chimes, notifications, and baseline message handling.

Control Name Control Type Options / Range Default Value Description
Interface Theme Segmented Buttons Light / Dark / System System Selects visual styling. System automatically matches your operating system’s dark mode preference.
Default Sending Account Dropdown Selector Configured accounts First Account The email identity automatically chosen when opening a new composer.
Startup Folder Dropdown Selector All Inboxes, Inbox, Starred, Drafts All Inboxes The initial folder displayed when DodaMail launches.
Interface Language Dropdown Selector English, German, French, Spanish, Hindi, etc. English (US) Updates all menus, tooltips, dialogs, and messages to the selected locale.
Compact Thread View Switch Toggle On / Off Off When enabled, compresses vertical padding in the thread list to show 40% more emails simultaneously.
Message Font Size Slider / Segmented Small (13px)
Medium (15px)
Large (17px)		 Medium Adjusts typography scale across reading panes and message lists.
Confirm Before Delete Switch Toggle On / Off On Displays a brief confirmation prompt before moving selected threads to the Trash.
Desktop Notifications Switch Toggle On / Off On Uses native OS notification banners for incoming emails.
Notification Sound Alerts Switch Toggle On / Off On Plays an audible sound chime when a new message arrives.
Sound Alert Profile Dropdown Selector Subtle Chime
Modern Ping
Bell Ding
Mute		 Subtle Chime Selects the audio sample used for new message alerts.
Sound Volume Horizontal Slider 0% to 100% 75% Adjusts master playback volume for in-app audio alerts.

2. Accounts Tab

Manages IMAP and SMTP connections. Complete documentation of the Account Setup Dialog is found in the Multi-Account Management Guide.

  • “Add Account” Button: Launches the account creation wizard.
  • Account Cards Table: Displays active email accounts with server type, color badges, and status.
  • “Edit Account” Button: Modifies passwords, server hostnames, or encryption parameters.
  • “Make Default” Button: Elevates selected account to default sender.
  • “Remove Account” Button: Deletes account configuration from local SQLite storage.

3. Signatures Tab

Manages HTML and plain-text signatures. Detailed in Signatures, Templates & Snippets.

  • “Create New Signature” Button: Opens the rich text signature builder.
  • Signature List: Table showing signature title, assigned account, and default status.
  • “Edit” & “Delete” Actions: Updates or deletes signature profiles.

4. Templates & Snippets Tab

Manages canned responses and ;keyword text expansion macros. Detailed in Signatures, Templates & Snippets.

  • Template Manager Sub-tab: Add, edit, or categorize dynamic response templates with {{name}} variables.
  • Snippets Sub-tab: Configure trigger shortcuts (e.g. ;thx, ;zoom) and test live expansions in the sandbox typing box.

5. Rules Tab

Manages deterministic email automation and filtering. Detailed in Filter Rules & Automation.

  • “Create New Rule” Button: Opens the multi-condition rule builder.
  • Priority Reorder Buttons (▲/▼): Adjusts sequential execution precedence.
  • Active Toggles: Disables or enables individual rules without deleting logic.
  • “Run Now on Folder” Button: Retroactively executes rules across existing mailboxes.
  • “Import Gmail Filters” Button: Imports mailFilters.xml exports directly.

6. Keyboard Shortcuts Tab

Displays and customizes keyboard shortcuts across the application. Detailed in Shortcuts & Command Palette.

  • Shortcut Search Bar: Filter keybindings by action name (e.g., Reply, Archive, Search).
  • Keybinding Modifier Fields: Click any shortcut box to record a custom keystroke combination.
  • “Reset to Factory Defaults” Button: Reverts all shortcuts back to standard Gmail/Superhuman bindings.

7. Privacy & Security Tab

Configures tracking protections and blocked senders. Detailed in Contacts & Privacy Shield.

Control Name Control Type Default Description
Block Remote Images Switch Toggle On Prevents automatic downloading of external web images to shield IP address.
Spy Pixel Neutralizer Switch Toggle On Scans incoming emails and disables 1x1 tracking beacons and tracking URLs.
Blocked Senders Directory Data Table Lists emails Shows blocked addresses/domains with options to remove or modify actions (Spam vs Delete).
OS Keyring Status Badge Status Pill Active Verifies healthy connection to GNOME Keyring, Windows Credential Manager, or macOS Keychain.
“Clear Image Cache” Button Action Button Enabled Flushes all locally stored cached thumbnails and inline images.

8. Data & Storage Tab

Manages backups, data retention, and disk usage. Detailed in Backup, Restore & Security.

  • “Create Full Backup” Button: Archives SQLite database and settings into .dodabak.
  • “Export Configuration” Button: Exports rules, snippets, and signatures to portable .json.
  • “Restore from Backup” Button: Imports and validates archives with SHA-256 verification.
  • Auto-empty Trash Dropdown: Retain for 14, 30, 60 days, or Never.
  • Auto-empty Spam Dropdown: Retain for 14, 30, 60 days, or Never.
  • “Purge All Data & Reset” (Red Button): Factory reset with RESET-ALL safety code.

9. License & Seats Tab

Manages activation, device seats, and renewals. Detailed in 2-Seat Device Licensing.

  • License Status Badge: Displays Trial, Lifetime, or Subscription status.
  • Active Seats Counter: Shows current device allocation (e.g., 1 / 2 Seats Used).
  • Device ID Field: Anonymized, non-hardware bound installation hash with Copy button.
  • License Key Input: Enter or update 16-24 character product activation key.
  • “Activate License” Button: Contacts store API to register machine.
  • “Deactivate This Machine” Button: Frees up seat allocation for another computer.
  • “Buy Upgrade / Renew” Button: Links directly to https://dodatech.com/shop/.

10. About & System Diagnostics Tab

Displays low-level engine diagnostics and legal information.

  • DodaMail Client Version: (e.g., v2.4.0-stable).
  • Rust Core & Tauri Framework Version: (e.g., Tauri v2.1.0).
  • SQLite Engine Version: (e.g., SQLite 3.45.1 with FTS5 enabled).
  • Database Status Indicator: Verifies database file size, WAL status, and total indexed message count.
  • Website & Documentation Links: Direct links to https://docs.dodatech.com/ and support forums.
  • Open Source Credits: View licenses for third-party libraries (Lucide, Tailwind, React, Rusqlite).