Settings Overview Open settings via TablePro > Settings or Cmd+,.
Settings Categories
General Language, startup behavior, updates
Appearance Themes, colors, and fonts
Editor SQL editor configuration
Data Grid Row height, date format, display
License License activation
General Settings Language Option Description System Follow macOS system language (default) English English Tiếng Việt Vietnamese Türkçe Turkish
Changing the language requires restarting TablePro.
Startup Behavior Option Description Show Welcome Screen Display the welcome screen with recent connections Reopen Last Session Auto-reconnect to your last database
Query Execution Timeout Set the maximum time a query runs before cancellation:
Setting Default Range Description Query timeout 60 seconds 0 — 600 Maximum seconds to wait. 0 means no limit.
The timeout is enforced at the database level:
Database Mechanism PostgreSQL SET statement_timeout (all statements)MySQL SET SESSION max_execution_time (SELECT queries)MariaDB SET SESSION max_statement_time (SELECT queries)SQLite sqlite3_busy_timeout (lock contention)
The timeout applies when a new connection is established. Changing it requires reconnecting.
Software Update Setting Default Description Automatically check for updates On Periodically check for new versions in the background Check for Updates… — Check right now
TablePro uses Sparkle for updates. When an update is available, a dialog shows release notes and an install option.
Also available from the TablePro menu > Check for Updates… .
Privacy Setting Default Description Share anonymous usage data On Sends anonymous stats (OS version, architecture, locale, database types) every 24 hours
No personal information, queries, or database content is transmitted. Toggle off at any time.
Data Grid Settings Font Setting Default Range Description Font family System Mono System Mono, SF Mono, Menlo, Monaco, Courier New Monospace font for data grid cells Font size 13 pt 10-18 pt Text size in data grid cells
Affects all data grid cells, including NULL placeholders and cell editing overlays. A live preview is shown in the settings panel.
The data grid font is independent of the SQL editor font. You can use different fonts and sizes for each.
Row Height Option Height Best For Compact 20px Dense data, more rows visible Normal 24px Balanced (default) Comfortable 28px Better readability Spacious 32px Accessibility
Format Example ISO 8601 2024-12-31 23:59:59 ISO Date 2024-12-31 US Long 12/31/2024 11:59:59 PM US Short 12/31/2024 EU Long 31/12/2024 23:59:59 EU Short 31/12/2024
ISO 8601 is recommended for consistency, especially with international teams.
NULL Display Setting Default Description NULL Display ”NULL” Text shown for NULL values
Options:
NULL - Standard database notation(null) - Parenthesized∅ - Empty set symbolCustom text (max 20 characters)
Page Size Range Minimum Maximum Default Page Size 10 100,000 1,000
Larger page sizes use more memory but show more data at once.
Validation ranges:
Page Size : 10 — 100,000 rows (values outside this range are clamped)NULL Display : Maximum 20 characters, no newlines or tabs Alternate Row Colors Option Description On Zebra striping for easier scanning Off Uniform background color
Row Numbers Option Description On Show row number column (#) as the first column Off Hide the row number column
Auto-Show Inspector Setting Default Description Auto-show inspector on row select Off Open the right sidebar automatically when selecting a row in a table tab
Tab Settings Reuse Clean Table Tab Setting Default Description Reuse clean table tab Off Clicking a new table in the sidebar replaces the current table tab instead of opening a new one
A tab is “clean” when all of these are true:
It’s a table tab (not query or create table)
Not pinned
No unsaved changes
You haven’t interacted with it (no sorting, filtering, row selection, etc.)
When off (default), every table click opens a new tab.
Enable this for single-tab browsing, similar to TablePlus’s default behavior.
Preview Tabs Setting Default Description Enable preview tabs On Single-clicking a table opens a temporary tab that gets replaced on next click
Single-clicking a table opens a preview tab that gets replaced on next click. Double-clicking or interacting with the tab (sorting, filtering, editing) makes it permanent.
Preview tabs show “Preview” in the subtitle and are not persisted across restarts.
Keyboard Settings Customize keyboard shortcuts for menu actions. See Keyboard Shortcuts for full details.
Rebinding Shortcuts
Open Settings > Keyboard
Click the shortcut field next to any action
Press the new key combination
Updates immediately
Conflict Detection Assigning a shortcut already in use shows a dialog with Cancel or Reassign options. System-reserved shortcuts (Cmd+Q, Cmd+H, Cmd+M, Cmd+,) cannot be reassigned.
Reset to Defaults Click Reset to Defaults to restore all shortcuts.
History Settings Maximum Entries Setting Default Description Max Entries 10,000 Maximum queries to keep
Set to 0 for unlimited.
Maximum Days Setting Default Description Max Days 90 Delete queries older than this
Set to 0 to keep history forever.
Auto Cleanup Option Description On Automatically remove old entries (default) Off Manual cleanup only
Disabling auto cleanup with unlimited entries may cause the history database to grow very large over time.
Clear History
Open Settings > History
Click Clear All History
Confirm the action
Plugins Settings Manage database driver plugins from the Plugins tab in Settings.
Installed Plugins Split-view: plugin list on the left, details on the right. Each row shows version, capability, and source (built-in or user-installed). Filter by name using the search field.
TablePro ships with 3 built-in database driver plugins (MySQL, PostgreSQL, SQLite) and 3 built-in export plugins (CSV, JSON, SQL). Additional plugins are available from the plugin registry and can be installed from the Browse tab or downloaded automatically when you select a database type:
Plugin Database Types Default Port Distribution MySQL MySQL, MariaDB 3306 Built-in PostgreSQL PostgreSQL, Redshift 5432 Built-in SQLite SQLite — Built-in ClickHouse ClickHouse 8123 Registry SQL Server SQL Server 1433 Registry MongoDB MongoDB 27017 Registry Redis Redis 6379 Registry DuckDB DuckDB — Registry Oracle Oracle 1521 Registry
Toggle plugins on/off in the detail pane. Disabled plugins hide their database type from the connection dialog.
Plugin Details Select a plugin to view version, bundle ID, capabilities, database type, and default port. Driver plugins can provide custom settings panels in this view.
Browse plugins The Browse tab uses the same split-view. Each row shows version, author, download count, and install status. Filter by name or category. Click a plugin for details, or install directly from the list.
Installing Third-Party Plugins
Click the + button below the plugin list
Select a .zip archive containing a .tableplugin bundle
TablePro verifies the code signature and installs the plugin
You can also drag and drop a .tableplugin or .zip file onto the Plugins settings view to install it.
Only install plugins from sources you trust. TablePro checks the code signature of sideloaded plugins but cannot guarantee their behavior.
Uninstalling Plugins Select a user-installed plugin and click - , or use Uninstall in the detail pane. Built-in plugins can only be disabled, not uninstalled.
Advanced Settings Some settings are available via defaults write for advanced users:
Setting Command Description Custom plugin registry defaults write com.TablePro com.TablePro.customRegistryURL <url>Use a private plugin registry Clear custom registry defaults delete com.TablePro com.TablePro.customRegistryURLRevert to default registry
Sync settings Manage iCloud sync from the Sync tab in Settings. This is a Pro feature.
iCloud Sync toggle Setting Default Description iCloud Sync Off Enable or disable iCloud sync across all Macs
Status Element Description iCloud Account Shows the current iCloud account status Last Sync Timestamp of the most recent sync Sync Now Manually trigger a sync
Sync categories Setting Default Description Connections On Sync connection details (not passwords) Groups & Tags On Sync connection organization, including nested group hierarchy App Settings On Sync all 8 settings categories Query History On Sync query history
History limit Option Description 100 Sync last 100 queries 500 Sync last 500 queries 1,000 Sync last 1,000 queries Unlimited Sync all query history
Passwords are never synced. They remain in each Mac’s local Keychain.
See iCloud Sync for full details on conflict resolution, sync behavior, and troubleshooting.
License Settings Manage your license from the License tab in Settings.
Activating a License
Open Settings (Cmd+,) and select the License tab
Enter your license key
Click Activate
Once activated, the tab shows your registered email and license key.
Deactivating a License
Open Settings > License
Click Deactivate…
Confirm
Deactivating frees up the activation slot for use on a different machine.
Offline Use License validation is local (cryptographic signature). No internet needed after activation. Re-validates with the server every 7 days.
Settings Storage Settings are stored in:
~/Library/Preferences/com.TablePro.plist
Resetting Settings To reset everything to defaults:
# Remove preferences file rm ~/Library/Preferences/com.TablePro.plist # Remove cached settings rm -rf ~/Library/Caches/com.TablePro
Then restart TablePro.
Resetting preferences does not affect saved connections or query history.
Keyboard Shortcut Action Shortcut Open Settings Cmd+,
