Settings

Every Kard setting, grouped by area. Each row lists what the setting does, its default, and its scope (who it affects). Scan for the one you need.

Where Kard settings live

You can reach Kard’s settings two ways:

• Kard’s own Settings panel — open Kard, then open Settings from the toolbar. It groups pages into sections: Workspace, Tasks, Appearance, Shortcuts, Identity, AI, and Advanced. It opens on the Vault folders page.
• Editor Preferences / Project Settings → Plugins — the same settings also appear under the engine’s Plugins category, in four sections: Kard, Kard User Settings, Kard MCP, and Kard AI.

Scope badges

Every setting in Kard’s panel carries a scope badge telling you who it affects:

Badge	Meaning
Team	Shared with everyone on the project. Saved to a project config file checked into source control.
You	Only affects you on this machine. Never shared with the team.
This folder	Applies only to the current folder.
View only	Read-only — shown for reference, not editable here.

TODO — Screenshot

The Kard Settings panel with a setting card showing its scope badge (e.g. a Team or You badge) — so readers recognize the badge model when they see it in the panel.

Folders

Where Kard stores each kind of asset. Scope: Team for all rows.

Setting	What it does	Default
Tasks folder	Sub-folder for Task assets.	/Game/Kard/Tasks
Notes folder	Sub-folder for Note assets.	/Game/Kard/Notes
Pages folder	Sub-folder for Page assets.	/Game/Kard/Pages
Attachments folder	Shared folder for image attachments. Every Kard-authored image (clipboard paste, viewport capture, drag-and-drop import) lands here.	/Game/Kard/Attachments
Tombstones folder	Folder where deletion records are written, one per deletion.	/Game/Kard/Tombstones
Tombstone retention days	Auto-remove deletion records older than this many days when you open the Activity view. 0 keeps them until you clear them manually.	0

Note

The Kard root folder (/Game/Kard) is fixed and not configurable. You can only change the sub-folders above.

Tasks and tags

Vocabulary and visuals for tasks. Scope: Team for all rows.

Setting	What it does	Default
Categories	The list of task categories you can pick from.	See note below
Category icons	An optional icon per category, shown in List-view group headers when you group by category.	Empty
Tag colors	Optional per-tag color overrides, shown as tinted pills. Tags without an entry get a color automatically.	Empty

TODO

Confirm the documented default for Categories. The code header initializes it empty, but the shipped project config seeds 12 categories (Character AI, Animation, Combat, Level Design, Lighting & VFX, Audio, UI & HUD, Collision, Performance, Bug Fix, Cinematics, Gameplay). On a fresh project the effective default is the 12 seeded categories — confirm that’s what we document, not “empty”.

History and identity

Edit-history behavior and team accounts. Scope: Team for all rows.

Setting	What it does	Default
Save records history by default	When on, every save logs an edit-history entry; Shift-click Save makes a single save quiet. When off, saves are quiet by default and Shift-click logs.	On
Users directory path	Asset path of the shared team user directory holding every local account. Only an admin who can check the file out may change the roster.	/Game/Kard/KardUsers

Markdown and video

Controls for inline video embeds and remote thumbnails. Scope: Team for all rows.

Setting	What it does	Default
Fetch remote video thumbnails	When on, !video[url] embeds fetch the provider’s preview image over the web. Off → embeds show a clickable placeholder instead. This is the only outbound network request Kard makes on its own.	On
Enable inline video playback	Master switch for playing !video[...] direct streams and local files inside the editor. Needs the optional media integration module and the Electra Player plugin.	On
Inline video host allowlist	Hosts allowed to serve inline video. Empty means any public host is permitted; private and loopback addresses are always blocked.	Empty
Inline video base URL	Optional base URL used to resolve relative !video[...] references. Empty → relative refs resolve to local files in your project’s Content folder.	Empty

Viewport and performance

How Kard badges look and draw in the level. Scope: Team for all rows here.

Setting	What it does	Default
Show in game view	When on, Kard badges stay visible after you press G (Game View) and in PIE. Off → they hide so the level looks shipping-clean.	Off
Default max draw distance	Default maximum draw distance for Kard badges in the level. 0 = unlimited. You can override this per-machine (see Workspace).	0
Viewport profiles	Studio-defined viewport display profiles, looked up by name.	Empty
Default level context class	The class used when you create a level-anchored card. Teams can subclass this for their own world model.	Built-in simple level context

Source control

Setting	What it does	Default	Scope
Git web commit URL pattern	When your source control is Git, the “open commit externally” action substitutes the commit hash into this URL. Empty → clicking copies the hash to your clipboard instead.	Empty	Team

Workspace (your personal settings)

These affect only you on this machine and are never shared. Scope: You for all rows.

Layout and navigation

Setting	What it does	Default
Show rail section labels	Show a small caption (Home / Tasks / Pages / Notes) under each navigation-rail icon.	On
Restore session on startup	When on, reopen the workspace tabs you had open when you last closed Kard. Off → opens clean.	On

Tasks list

Setting	What it does	Default
Visible task columns	Which columns the Tasks list shows, in order.	Status, Spatial, Title, Tags, Priority, Assignee, Created
Task sort column	Which column the list sorts by within each group.	Created
Sort ascending	Default sort direction (ascending = oldest first for dates). Flip it per-scope with the column header.	On
Default group by	How a Tasks folder is grouped the first time you open it.	Category
Default group sort order	How group headers are ordered.	Name A–Z
Saved views	Filter/layout views you’ve saved. Never shared with the team.	Empty
Board view default sort	Default sort the first time a folder opens in Board view (the Board has no clickable headers).	Oldest first

Notes drawer

Setting	What it does	Default
Animation duration	Drawer slide-in time, in seconds.	0.18
Width fraction	Fraction of the available width the drawer aims for.	0.7
Minimum width	Smallest the drawer can be, in pixels.	480
Maximum width	Largest the drawer can be, in pixels.	1100

Pages reading time

Used to estimate read time on Pages.

Setting	What it does	Default
Reading words per minute	Reading speed used for the estimate.	220
Seconds per code block	Time added per code block.	30
Seconds per heading	Time added per heading.	3
Seconds per image	Time added per inline image.	15

Appearance and drawing

Setting	What it does	Default
Max draw distance override	Your per-machine override of the project default. -1 = follow project, 0 = unlimited.	-1
Hover scale	How much a badge grows when you hover it.	1.10
Outline color	Outline color on hovered cards.	Gold
Active viewport profile	Name of your active viewport profile. Empty = the default profile.	Empty

MCP server

The MCP server lets local AI tools talk to Kard. It ships off and, when on, listens on your own machine only (loopback, 127.0.0.1) — never on the network. It’s an opt-in power feature; you don’t need it for normal use. Scope: Team for all rows.

Setting	What it does	Default
Enable MCP server	Master switch. When on, the server starts when the editor boots and listens on 127.0.0.1 only.	Off
Port	Local port the server listens on (loopback only). Changing it while running restarts the server.	30050
Log verbose request diagnostics	Logs each request to a small in-panel buffer for troubleshooting. Off keeps the editor lean.	Off
Allow source-file reads	Lets AI tools read source files. Even when on, reads are restricted to your project’s and plugins’ Source/ folders.	On
Max Blueprint graph nodes per call	Caps how many Blueprint graph nodes a single request can read.	200

Note

Who can do what is controlled by a per-action trust matrix (the Resource Gates setting). By default, read actions are allowed and write actions are off, so a connected tool can look but not change anything until you opt in. The matrix lives in the MCP settings page; deeper detail is out of scope for this reference.

Note

The server’s bind address is fixed to loopback (127.0.0.1) by design and is not an editable setting. It cannot be exposed to the network.

AI (bring your own key)

Kard’s optional in-editor AI chat. It ships off, and your API key is stored in your per-user config so it never lands in source control. Scope: You for all rows.

Setting	What it does	Default
Enable AI	Master switch. When on, the chat panel and one-shot AI actions become available. Needs the active provider’s API key.	Off
Provider	Which AI provider is active. Empty falls back to the built-in default.	None
Max output tokens	Cap on how long each AI response can be (the provider’s own caps still apply).	4096
Grant MCP tool access to AI	When on, the AI can read and change the project through the same tools external clients use. Its edits are stamped as “KardAI”.	On
Allow the AI to delete cards and comments	When on, the AI may delete cards and comments. Off → delete tools are hidden from the AI (a safety guard). Move and update are always allowed.	Off
Show token usage in chat	Show a running token count in the chat header — a guard against runaway loops.	On
System prompt	Text prepended to every conversation. Editable so studios can adjust tone.	Built-in Kard prompt

Per-provider settings

For the active provider, you also set:

Setting	What it does	Default
API key	Your provider key. Shown masked. Leave empty for providers that need no key.	Empty
Model	The model to use. Can be refreshed from the provider’s model list.	Empty
Base URL	Optional endpoint override (for gateways or self-hosted setups). Empty = the provider’s standard URL.	Empty

Note

Grant MCP tool access and Allow the AI to delete only matter once Enable AI is on — all AI controls are hidden until then. With AI enabled, tool access is on by default but deletion stays off.

TODO

Confirm whether to surface a security caveat for the API key: the code notes keys persist to the per-user config in plaintext (Unreal does not OS-encrypt them), with a future version planned to move them to the OS keychain. Decide if this belongs in a public reference.

Keyboard shortcuts

Kard’s shortcuts are not a setting on these pages. The Shortcuts page in Kard’s Settings panel lists every Kard chord (read-only) and offers an Open Keyboard Shortcuts button that takes you to Editor Preferences → General → Keyboard Shortcuts, where you can rebind them.

TODO

Add a cross-link to the dedicated Shortcuts reference page once its slug is confirmed.

A note on hidden settings

Some of your personal preferences are remembered automatically and never appear in any panel — for example, your last export options, per-folder group/layout choices, unread markers, and Activity-feed filters. They persist between sessions but aren’t meant to be edited by hand.

TODO

Confirm whether this reference should enumerate the config-only UKardUserSettings fields (export defaults, per-folder memory maps, unread maps, Home/Activity filters, seen-agents registry, welcome-seed flags) or only document the settings that actually appear in a panel. The summary above is the conservative choice; a human should decide the policy.

TODO

The scope-badge model includes a This folder scope, but none of the four settings classes is folder-scoped — folder-level settings (per-folder workflows, board columns) live on per-folder assets, not on these pages. Confirm whether to document folder-level settings here or defer to the Boards / Workflows guides.

Next steps

• Boards — create folders/boards and their columns.
• Cards — work with card fields, links, and editing.
• FAQ — storage, source control, and troubleshooting.