Back to resources

Categories Schema

Schemas & Deep Dives Reference Updated Sep 21, 2025

Share

Plain English

Categories provide names and icons for table groups. The app ships with built‑ins; you add your own alongside them.

Root structure

{
  "defaultCategories": [ /* built‑ins */ ],
  "categories": [ /* your custom categories */ ]
}
  • defaultCategories: built‑in list bundled with the app; you typically do not edit these
  • categories: your custom additions; add, rename, or remove here without touching built‑ins

TableCategoryInfo fields

  • id (kebab‑case string)
  • displayName (string)
  • iconKey (string; app icon registry key)
  • sortOrder (integer)
  • isBuiltIn (boolean)
  • Optional: description (string), displayNameTranslations (object)

Lifecycle in the app

  • First run: the app copies a baseline categories.json into your Documents (meaning_tables/categories.json)
  • Built‑ins live in defaultCategories and can be restored with “Reset to defaults”
  • Add your own categories only to the categories array

Downloads

See the Downloads section at the bottom of this page for files.

  • Getting started and organizing tips: “Getting Started with Custom Tables”, “Organizing Custom Tables”
  • Table schemas: “Custom Table Schema”

Downloads