2025-06-29 02:25:19 +00:00
# Settings
2026-02-21 02:41:32 +00:00
TaskNotes settings are organized into tabs. Each tab controls a different part of plugin behavior.
2025-06-29 02:25:19 +00:00
2025-08-13 12:12:14 +00:00
2025-09-13 11:50:39 +00:00
## General
2025-06-29 02:25:19 +00:00
2026-02-21 02:41:32 +00:00
The General tab controls task identification, storage locations, and task-card click behavior. Use this tab when your vault already has conventions such as custom tags, property-based identification, or specific folder structures.
2025-06-29 02:25:19 +00:00
2025-11-18 01:57:46 +00:00
For more information, see the [General Settings ](settings/general.md ) documentation.
2025-06-29 02:25:19 +00:00
2025-12-01 23:04:21 +00:00
## Task Properties
2025-06-29 02:25:19 +00:00
2026-02-15 01:10:28 +00:00
Task Properties defines the schema TaskNotes writes to frontmatter, including status, priority, dates, reminders, projects, and user fields. Each property card lets you remap key names and behavior so TaskNotes can match existing metadata rather than forcing a migration.
2025-12-01 23:04:21 +00:00
For more detailed information, see the [Task Properties Settings ](settings/task-properties.md ) documentation.
2025-06-29 02:25:19 +00:00
2025-12-01 23:04:21 +00:00
## Modal Fields
2025-06-29 02:25:19 +00:00
2026-02-15 01:10:28 +00:00
Modal Fields controls the task create/edit experience by deciding which fields are visible and in what order. If your workflow depends on a handful of fields, you can surface only those and reduce form noise.
2025-06-29 02:25:19 +00:00
2025-12-01 23:04:21 +00:00
For more information, see the [Modal Fields Settings ](settings/modal-fields.md ) documentation.
2025-06-29 02:25:19 +00:00
2025-09-13 11:50:39 +00:00
## Appearance & UI
2025-06-29 02:25:19 +00:00
2026-02-15 01:10:28 +00:00
Appearance & UI handles task card density, calendar defaults, time formatting, and visual toggles for supporting widgets. Use this tab to tune how much information is visible at a glance.
Feature/Custom User Fields Mapping: Option to filter on your own frontmatter properties (+ smarter list and numeric filtering) (#471)
* feat: implement multi-field user properties for dynamic filtering
- Add userFields[] data model with id, key, displayName, type
- Migrate legacy userField to userFields array on load
- Extend FilterOptions with userProperties from settings
- Update FilterBar to include user properties in dropdown
- Add evaluation logic for user:* property conditions
- Create Settings UI for managing multiple user fields
- Add comprehensive unit tests for all components
- Support Text, Number, Date, Boolean, List field types
* fix(settings/user-fields): widen inputs and align layout with Priority section
- Use grid tailored for user-fields (1fr 1fr 160px 80px)
- Make Property Name and Display Name inputs flex to full width
- Standardize type dropdown width; stack neatly on mobile
- Follow existing settings-view patterns for consistency
* feat: add bracket/quote-aware CSV splitting and missing numeric operators
- Add src/utils/stringSplit.ts with splitListPreservingLinksAndQuotes()
- Single-pass O(n) algorithm preserves commas inside [[...]] and quotes
- Handles wikilink aliases [[path|alias]] correctly
- Trims tokens and ignores empty values
- Integrate splitter in FilterService.normalizeUserListValue for string inputs
- Add missing numeric operators: is-greater-than-or-equal, is-less-than-or-equal
- Update FilterOperator type and FILTER_OPERATORS labels
- Add support for timeEstimate and user number fields
- Implement comparison logic in FilterUtils
- Fix instant user field availability in FilterBar after settings changes
- Invalidate filter options cache in main.saveSettings()
- Push fresh options to open views in settings.ts
- Add comprehensive unit tests for string splitting and filter normalization
- Fix TypeScript compilation issue with new operator validation
* docs: add comprehensive user fields documentation and examples
- Add User Fields section to Advanced Settings with setup guide
- Document all 5 field types (text, number, date, boolean, list) with examples
- Explain smart list filtering that preserves wikilinks and quotes
- Document numeric intelligence for mixed text-number formats
- Add new comparison operators (equal or greater/less than) to filtering docs
- Include practical filtering examples for custom user fields
- Add technical implementation guide for developers
- Include demonstration GIFs showing list and numeric field filtering
- Update main settings overview to reference user fields feature
2025-08-24 10:17:51 +00:00
2025-09-13 11:50:39 +00:00
For more detailed information, see the [Appearance & UI Settings ](settings/appearance.md ) documentation.
2025-06-29 02:25:19 +00:00
2025-12-01 23:04:21 +00:00
## Features
2025-11-18 01:57:46 +00:00
2026-02-15 01:10:28 +00:00
Features groups behavior toggles for inline tasks, natural language input, Pomodoro, reminders, and performance-related options. It is where you enable advanced workflow capabilities and then refine defaults.
2025-11-18 01:57:46 +00:00
2025-12-01 23:04:21 +00:00
For more information, see the [Features Settings ](settings/features.md ) documentation.
2025-11-18 01:57:46 +00:00
2025-09-13 11:50:39 +00:00
## Integrations
2025-08-09 01:11:59 +00:00
2026-02-15 01:10:28 +00:00
Integrations covers external connectivity: Bases view wiring, Google/Microsoft OAuth calendar sync, ICS subscriptions, automatic ICS export, HTTP API settings, and webhook endpoints.
2025-08-09 01:11:59 +00:00
2026-02-15 01:10:28 +00:00
For more detailed information, see the [Integrations Settings ](settings/integrations.md ) documentation.