--- title: "Settings reference — Kition" description: "Kition settings configure device behavior, accounts, model providers, email connections, and diagnostics. This reference identifies the version-specific sections and the scope of each choice." canonical: "https://kition.ai/docs/settings" --- > Canonical HTML: [https://kition.ai/docs/settings](https://kition.ai/docs/settings) [Docs home](https://kition.ai/docs) - Get started - [What is Kition](https://kition.ai/docs/what-is-kition) - [Install Kition](https://kition.ai/docs/install-kition) - [Open your first workspace](https://kition.ai/docs/create-first-vault) - [UI tour](https://kition.ai/docs/ui-tour) - [Configure an AI provider](https://kition.ai/docs/configure-provider) - [Protect provider credentials](https://kition.ai/docs/secure-api-key) - [Back up and move a workspace](https://kition.ai/docs/backup-and-sync) - Scenarios - [Real-world scenarios](https://kition.ai/docs/scenarios) - [Generate campaign assets in batches](https://kition.ai/docs/scenarios/campaign-assets) - [Turn receipt images into searchable records](https://kition.ai/docs/scenarios/receipt-ocr) - [Expand one product brief into a complete asset pipeline](https://kition.ai/docs/scenarios/product-asset-pipeline) - Document editor - [Markdown editing basics](https://kition.ai/docs/editor/markdown-basics) - [Wikilinks and backlinks](https://kition.ai/docs/editor/wikilinks-basics) - [Callout syntax](https://kition.ai/docs/editor/callouts-syntax) - [Command palettes and quick navigation](https://kition.ai/docs/editor/command-palette) - [Document templates](https://kition.ai/docs/editor/doc-templates) - [Document embeds and table-embed status](https://kition.ai/docs/editor/embed-table-in-doc) - [Math and Mermaid diagrams](https://kition.ai/docs/editor/math-and-diagrams) - [Export a document](https://kition.ai/docs/editor/export-pdf-docx) - [Translate selected text in AI Docs](https://kition.ai/docs/editor/inline-translation) - Data tables - [Create a table](https://kition.ai/docs/tables/create-a-table) - [Field types overview](https://kition.ai/docs/tables/field-types) - [Create and switch views](https://kition.ai/docs/tables/create-view) - [Filter, sort, and group](https://kition.ai/docs/tables/filter-sort-group) - [Configure AI on a table field](https://kition.ai/docs/tables/ai-field-setup) - [Import spreadsheet data](https://kition.ai/docs/tables/csv-import) - [Download a table as CSV](https://kition.ai/docs/tables/csv-export) - [Link documents and tables](https://kition.ai/docs/tables/link-doc-and-table) - AI agent - [Agent chat basics](https://kition.ai/docs/agent/agent-basics) - [Agent tool calls](https://kition.ai/docs/agent/agent-tool-calls) - [Plans, previews, and apply confirmation](https://kition.ai/docs/agent/plan-mode) - [Hooks status in Kition 0.1.41](https://kition.ai/docs/agent/hooks-intro) - [MCP setup status in Kition 0.1.41](https://kition.ai/docs/agent/mcp-setup) - [Browser context for the Agent](https://kition.ai/docs/agent/browser-tool) - [Control Agent usage and cost](https://kition.ai/docs/agent/agent-cost-control) - [Agent approvals and safety boundaries](https://kition.ai/docs/agent/agent-permissions) - Providers - [Set up OpenAI](https://kition.ai/docs/providers/openai-setup) - [Set up Anthropic](https://kition.ai/docs/providers/anthropic-setup) - [Set up a custom provider](https://kition.ai/docs/providers/custom-provider-setup) - [Set up common models](https://kition.ai/docs/providers/common-models-setup) - [Switch the active provider and model](https://kition.ai/docs/providers/switch-default-model) - Desktop & data - [Log and configuration locations](https://kition.ai/docs/desktop/log-and-config-locations) - [Updates and versioning](https://kition.ai/docs/desktop/app-update) - [Free, Plus, and Pro](https://kition.ai/docs/desktop/free-vs-pro) - [Uninstall Kition and remove app data](https://kition.ai/docs/desktop/uninstall-and-data) - Recipes - [Build an evidence table for a research report](https://kition.ai/docs/recipes/research-evidence) - [Create a campaign asset review queue](https://kition.ai/docs/recipes/campaign-review) - [Triage imported email with a review table](https://kition.ai/docs/recipes/inbox-triage) - [Review a product image asset pipeline](https://kition.ai/docs/recipes/product-asset-review) - [Prepare a project handoff with editable sources](https://kition.ai/docs/recipes/project-handoff) - [Turn meeting notes into a reviewed action table](https://kition.ai/docs/recipes/meeting-actions) - Reference - [Settings reference](https://kition.ai/docs/settings) - [Keybindings](https://kition.ai/docs/keybindings) - [Privacy and telemetry](https://kition.ai/docs/privacy) - [Agent is not responding](https://kition.ai/docs/agent-not-responding) - [Workspace folder is not syncing](https://kition.ai/docs/vault-not-syncing) - [Editor feels slow](https://kition.ai/docs/editor-laggy) - [Wikilinks or backlinks are missing](https://kition.ai/docs/wikilink-broken) - [CSV import fails](https://kition.ai/docs/csv-import-fail) - [PDF or DOCX export fails](https://kition.ai/docs/pdf-export-fails) - Whiteboards - [Create your first AI whiteboard](https://kition.ai/docs/whiteboards/get-started) - [Organize ideas with Whiteboard mind maps](https://kition.ai/docs/whiteboards/mind-maps) - [Draw a workflow as a Whiteboard flowchart](https://kition.ai/docs/whiteboards/flowcharts) - [Review Agent changes to a Whiteboard](https://kition.ai/docs/whiteboards/agent-review) - [Export a Whiteboard as PNG or SVG](https://kition.ai/docs/whiteboards/export) - Image generation - [Generate images in your Kition workspace](https://kition.ai/docs/images/generate) - [Edit an image using a reference](https://kition.ai/docs/images/edit-reference) - [Use image templates for a repeatable brief](https://kition.ai/docs/images/templates) - [Save generated images for documents and tables](https://kition.ai/docs/images/save-and-reuse) - [Troubleshoot image generation and editing](https://kition.ai/docs/images/troubleshooting) - Design Studio - [Create an editable poster in Design Studio](https://kition.ai/docs/design/get-started) - [Choose and customize a poster layout](https://kition.ai/docs/design/layouts) - [Edit poster layers, shapes, and typography](https://kition.ai/docs/design/layers) - [Combine generated images with editable poster text](https://kition.ai/docs/design/images-and-text) - [Export a design as PNG, JPEG, SVG, or PDF](https://kition.ai/docs/design/export) - [Set workspace brand colors, fonts, and a logo](https://kition.ai/docs/design/brand-kit) - [Create and export multiple design sizes](https://kition.ai/docs/design/size-variants) - [Create a design from an AI table record](https://kition.ai/docs/design/from-table-record) - [Preview and review AI design changes](https://kition.ai/docs/design/agent-review) - Visual workflows - [Build your first visual workflow](https://kition.ai/docs/workflows/get-started) - [Choose a workflow trigger and source table](https://kition.ai/docs/workflows/triggers) - [Schedule workflows with an explicit timezone](https://kition.ai/docs/workflows/schedules) - [Test a workflow with representative sample data](https://kition.ai/docs/workflows/test-actions) - [Inspect workflow runs and diagnose failures](https://kition.ai/docs/workflows/run-history) - Email workflows - [Connect an email provider in Kition](https://kition.ai/docs/email/connect-provider) - [Sync an email inbox into a Kition table](https://kition.ai/docs/email/sync-inbox) - [Send email from a visual workflow](https://kition.ai/docs/email/send-from-workflow) - [Troubleshoot email connection and sync errors](https://kition.ai/docs/email/troubleshooting) - Articles - [How to open a .kitable template in Kition](https://kition.ai/docs/articles/open-kitable-template-in-kition) - [Preview a Kition workflow email without sending it](https://kition.ai/docs/articles/preview-workflow-email-without-sending) - [Unresolved workflow field reference: how to repair bindings safely](https://kition.ai/docs/articles/workflow-field-reference-unresolved) - [AI image field attachments not loading: safe troubleshooting steps](https://kition.ai/docs/articles/ai-image-field-attachments-not-loading) - [Receipt OCR missing fields: review and recovery checklist](https://kition.ai/docs/articles/receipt-ocr-missing-fields-review) - [What is Kition? A 5-minute product tour](https://kition.ai/docs/articles/what-is-kition) [Docs](https://kition.ai/docs)/Reference/Settings reference Reference # Settings reference Kition settings configure device behavior, accounts, model providers, email connections, and diagnostics. This reference identifies the version-specific sections and the scope of each choice. Updated 2026-09-30 By Kition Docs Verified against Kition 0.1.41 (d3e1b931) on 2026-08-29 ## Change a setting and verify its effect Choose the setting by what it controls. A provider configuration is different from the project content you want to send, and a saved email account is different from a running inbox workflow. Use the version boundary below when comparing these instructions with your installation. 1. Open Settings and identify the relevant category. 2. Review the account, path, or provider affected by the change. 3. Change one value and use the available save or test control. 4. Follow any explicit restart instruction shown for that setting. 5. Return to the relevant work surface and verify the intended behavior. Settings versus project content Kind Example Device preference Appearance or application behavior Service connection AI provider or email account Project content Document, table, board, or design in the workspace Execution configuration A workflow’s input, action, and schedule ## Current navigation These are the sections rendered by the 0.1.41 Settings page. Older references to Settings panes named MCP, Hooks, or Shortcuts do not describe the current navigation. - General - Account - AI Providers - Email Providers - Display - Network - Advanced → Data - Advanced → Developer - About ## General, account, providers, and display - General — application behavior and the anonymous usage analytics control; analytics are off by default - Account — Kition account, subscription, and hosted-credit state - AI Providers — connect external model providers, synchronize available models, and select an active provider/model - Email Providers — configure supported email connections - Display — appearance and document-interface preferences Heads up Provider and proxy secrets are stored in plaintext `.secret` files under the local application data directory in 0.1.41. They are not protected by the operating-system Keychain. ## Network Network configures the Desktop proxy. Supported proxy types are HTTP, HTTPS, SOCKS5, and SOCKS5H. The form accepts host, port, optional username and password, and bypass rules, and provides proxy testing plus the restart flow needed to apply changes. The proxy password uses the same local plaintext secret store as provider credentials. Protect the application data directory and revoke or rotate remote credentials if the device is lost or transferred. ## Advanced and About Use Support diagnostics before sharing raw logs. The copied diagnostic summary is redacted; raw logs still require inspection and redaction. - Data — displays the resolved local data, cache, logs, and exports paths and can open them in the operating system - Developer — includes Debug mode; enabled debug logging can contain model request and Agent turn details - About — displays version, commit, and build time and provides updates, Support diagnostics, feedback, privacy, terms, GitHub, and license links ## Implementation sources - [v0.1.41: src/features/settings/DesktopSettingsPage.tsx](https://github.com/KitionAI/kition/blob/v0.1.41/src/features/settings/DesktopSettingsPage.tsx) - [v0.1.41: src/features/settings/NetworkSettings.tsx](https://github.com/KitionAI/kition/blob/v0.1.41/src/features/settings/NetworkSettings.tsx) - [v0.1.41: src/services/desktopSettings.ts](https://github.com/KitionAI/kition/blob/v0.1.41/src/services/desktopSettings.ts) - [v0.1.41: electron/secure-store.mjs](https://github.com/KitionAI/kition/blob/v0.1.41/electron/secure-store.mjs) ## Related pages [ ### Privacy and telemetry Privacy and telemetry describe where workspace data goes and which optional usage events are collected. Local storage does not mean every connected feature operates without network requests. ](https://kition.ai/docs/privacy)[ ### Keybindings Keybindings are keyboard shortcuts interpreted by the active application, workspace, or document surface. The focused surface determines which action a key combination performs. ](https://kition.ai/docs/keybindings)[ ### Log and configuration locations Find the active data, cache, log, export, workspace, and configuration locations from the running Desktop app. ](https://kition.ai/docs/desktop/log-and-config-locations) On this page - [Change a setting and verify its effect](#section-0) - [Current navigation](#section-1) - [General, account, providers, and display](#section-2) - [Network](#section-3) - [Advanced and About](#section-4) ## Ready when you are. Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents. [Download Kition](https://kition.ai/download)[Pricing](https://kition.ai/pricing)