datlechin · Oct 12, 2026 · Oct 11, 2026
diff --git a/customization/data-settings.mdx b/customization/data-settings.mdx
@@ -1,17 +1,25 @@
 ---
 title: Data Settings
-description: Data grid, pagination, query result cap, JSON viewer, and query history
+description: Data grid font, pagination, query result cap, JSON viewer, and query history
 ---
 
 Browsing a table pages 1,000 rows at a time, and a query that returns more than 10,000 rows stops there. Both numbers, and the rest of what the grid does before you touch anything, are on **Settings > Data**.
 
-The tab is app-wide, so these values apply to every connection you open; filters, column widths, and the sort you clicked are remembered per table instead. Grid fonts are per-theme, on the theme's Fonts tab under [Appearance](/customization/appearance).
+The tab is app-wide, so these values apply to every connection you open; filters, column widths, and the sort you clicked are remembered per table instead. The font here is set per Mac, not per theme, and is not synced.
 
 <Frame caption="The Data tab in Settings">
   <img className="block dark:hidden" src="/images/settings-data.png" alt="Data settings tab" />
   <img className="hidden dark:block" src="/images/settings-data-dark.png" alt="Data settings tab" />
 </Frame>
 
+## Font
+
+| Setting | Default | Applies to |
+|---------|---------|------------|
+| Data Grid Font | System Mono, 13 pt | Grid cells, the inspector, the cell popovers and the Compare row diff |
+
+The picker lists the monospaced families installed on your Mac, at 10 to 24 pt.
+
 ## Data Grid
 
 | Setting | Default | Notes |

diff --git a/customization/editor-settings.mdx b/customization/editor-settings.mdx
@@ -1,11 +1,11 @@
 ---
 title: Editor Settings
-description: SQL editor, Vim mode, line numbers, indentation, and query parameter settings
+description: SQL editor font, Vim mode, line numbers, indentation, and query parameter settings
 ---
 
 **Settings > Editor** covers typing and how SQL is displayed. Grid, pagination, result cap and JSON viewer settings are on the [Data](/customization/data-settings) tab instead.
 
-Editor fonts are per-theme. Edit them on the theme's Fonts tab under [Appearance](/customization/appearance).
+The font here is set per Mac, not per theme, and is not synced.
 
 <Frame caption="Editor settings">
   <img className="block dark:hidden" src="/images/settings-editor.png" alt="Editor settings" />
@@ -24,7 +24,7 @@ The picker lists the monospaced families installed on your Mac, at 10 to 24 pt.
 
 | Setting | Default | Notes |
 |---------|---------|-------|
-| Show line numbers | On | |
+| Show line numbers | On | Turning this off also hides the per-statement run button |
 | Highlight current line | On | |
 | Highlight current statement | On | A faint band behind the statement the cursor is in. See [Statement markers](/features/sql-editor#statement-markers) |
 | Show invisible characters | Off | See [Invisible characters](/features/sql-editor#invisible-characters) |

diff --git a/customization/settings.mdx b/customization/settings.mdx
@@ -12,7 +12,7 @@ The settings window is app-wide: a value on any of these twelve tabs holds for e
 
 <CardGroup cols={2}>
   <Card title="General" icon="gear" href="/customization/general-settings">Language, startup, tabs, sidebar, connections, query timeout, updates, reset.</Card>
-  <Card title="Appearance" icon="palette" href="/customization/appearance">Appearance mode, themes, per-theme fonts and colors.</Card>
+  <Card title="Appearance" icon="palette" href="/customization/appearance">Appearance mode, themes and theme colors.</Card>
   <Card title="Editor" icon="code" href="/customization/editor-settings">SQL editor, Vim mode, line numbers, query parameters.</Card>
   <Card title="Data" icon="table" href="/customization/data-settings">Data grid, pagination, result cap, JSON viewer, and query history.</Card>
   <Card title="Keyboard" icon="keyboard" href="/features/keyboard-shortcuts#customizing-shortcuts">Custom shortcuts.</Card>
@@ -51,8 +51,7 @@ What a fresh install ships with, so one glance down this column says what you ch
 | Appearance | Appearance | Auto |
 | Appearance | Light theme | Default Light |
 | Appearance | Dark theme | Default Dark |
-| Appearance | Editor font | System Mono, 13 pt |
-| Appearance | Data grid font | System Mono, 13 pt |
+| Editor | Editor font | System Mono, 13 pt |
 | Editor | Show line numbers | On |
 | Editor | Highlight current line | On |
 | Editor | Highlight current statement | On |

diff --git a/development/plugin-registry.mdx b/development/plugin-registry.mdx
@@ -151,9 +151,9 @@ The app fetches the manifest from `raw.githubusercontent.com/TableProApp/plugins
 Themes use the same manifest with `category: "theme"`. Four things differ from a driver:
 
 - Pure JSON data. No executable code, no code signing, no `.tableplugin` bundle
-- The ZIP holds `.json` files, each a valid `ThemeDefinition`. Packs with several themes work
+- The ZIP holds `.json` files, each a theme file in format `schema: 2`. Packs with several themes work
 - They install to `~/Library/Application Support/TablePro/Themes/Registry/`
-- No `pluginKitVersion` is needed, and the flat v1 fields still decode
+- No `pluginKitVersion` is needed. Set `minAppVersion` to the release that reads the format the theme is written in, because that is the only check an older TablePro runs before installing it
 
 ```json
 {

diff --git a/features/overview.mdx b/features/overview.mdx
@@ -215,7 +215,7 @@ First time here: [Quick Start](/quickstart) gets you from install to a query wit
     Every tab, its controls, and their defaults.
   </Card>
   <Card title="Appearance" icon="palette" href="/customization/appearance">
-    Themes, fonts, colors, connection colors.
+    Themes, theme colors, connection colors.
   </Card>
   <Card title="Editor Settings" icon="pen-ruler" href="/customization/editor-settings">
     Editor toggles, Vim mode, indentation.

diff --git a/features/sql-editor.mdx b/features/sql-editor.mdx
@@ -241,6 +241,6 @@ For the execution plan rather than an opinion, press `Cmd+Option+E` and see [Exp
 
 ## Editor settings
 
-**Settings > Editor** holds line numbers, current-line and current-statement highlighting, word wrap, [code folding](/features/code-folding), the per-statement run button, [invisible characters](#invisible-characters), tab width, [keyword case](/features/autocomplete#keyword-case), [query parameters](/features/query-parameters), and [vim mode](/features/vim-mode). Editor font family and size are per theme, in **Settings > Appearance**.
+**Settings > Editor** holds line numbers, current-line and current-statement highlighting, word wrap, [code folding](/features/code-folding), the per-statement run button, [invisible characters](#invisible-characters), tab width, [keyword case](/features/autocomplete#keyword-case), [query parameters](/features/query-parameters), and [vim mode](/features/vim-mode). Editor font family and size are on that same tab.
 
-Editor windows remember their size, position and font zoom between launches. See [Query Tabs](/features/tabs#switching-tabs).
+The font size set by `Cmd+=` and `Cmd+-` is the Editor Font setting, so it is kept between launches. See [Query Tabs](/features/tabs#switching-tabs).