DenchClaw List View: Quick Scanning for Power Users
How DenchClaw's compact list view helps power users scan and act on hundreds of records quickly without visual clutter.
DenchClaw List View: Quick Scanning for Power Users
DenchClaw's list view is the most compact display mode — a dense, fast-loading presentation of your CRM entries designed for power users who need to scan and act on large datasets quickly. Where table view prioritizes column-level detail and gallery view prioritizes visual identity, list view prioritizes raw throughput: you can scan hundreds of entries per screen and take bulk actions without ever losing your place.
When to Use List View#
List view is optimal when:
- Bulk processing — reviewing and acting on a large number of records sequentially
- Quick status scanning — confirming entries are correct without needing column details
- Task list workflows — processing a queue of items in order
- Mobile browsing — compact layout works well on smaller screens
- Known data — you already know what you're looking for, just need to find and action it
Use table view when you need to compare specific field values across many records. Use list view when you need to move through records fast.
Setting Up List View#
Configure in .object.yaml:
default_view: list
view_settings:
list:
primaryField: Full Name # Main title line
secondaryField: Company # Subtitle line
metaField: Status # Status badge on right
secondaryMetaField: Last Contacted # Small meta below status
showCreatedAt: false
density: compact # compact or comfortableOr switch any existing view to list mode via the view type selector in the frontend.
List Item Anatomy#
Each list item is a horizontal row containing:
[ Checkbox ] [ Avatar/Icon ] Title text [ Meta field ]
Subtitle text [ Date ]
- Checkbox — for bulk selection
- Avatar — initial-based avatar or profile image
- Title — primary field (name, deal name, etc.)
- Subtitle — secondary identifier (company, stage, etc.)
- Meta field — status badge or key value (right side)
- Date — relative timestamp (last contacted, created, etc.)
Clicking a row opens the full entry detail view. Right-clicking shows a context menu with quick actions.
Keyboard Navigation in List View#
List view is the most keyboard-friendly DenchClaw view. Power user shortcuts:
↑/↓— navigate between entriesEnter— open selected entrySpace— toggle selection on current entryCmd+A— select all visible entriesE— edit selected entry inline (if enabled)D— delete selected entries (with confirmation)/— focus search input to filter in place
These shortcuts make list view work like a proper productivity tool for processing queues of entries.
Density Modes#
Compact density (default for list view):
- Minimum row height
- 8-12px vertical padding
- No extra whitespace
- Maximum entries visible per screen
Comfortable density:
- More vertical padding
- Slightly larger text
- Better for touch screens or when entries need more breathing room
Switch density with the density toggle in the view options panel, or set it in YAML:
view_settings:
list:
density: compact # or comfortableBulk Actions in List View#
List view's checkbox column enables bulk operations — select multiple entries and apply an action to all:
- Bulk update field — change Status for 50 selected leads at once
- Bulk tag — add or remove tags from selected entries
- Bulk delete — remove multiple entries (with confirmation)
- Bulk export — export selected entries to CSV
- Bulk action — trigger an action field script on selected entries
Bulk operations are the primary reason to choose list view over gallery when processing large datasets.
Inline Editing in List View#
Double-click any field in a list row to edit it inline without opening the full entry view. Supported for:
- Text fields
- Enum fields (dropdown appears)
- Date fields (datepicker appears)
- Number fields
- Boolean fields (toggles on click)
Press Tab to move to the next editable field. Press Enter or click elsewhere to save.
Using List View for Task Processing#
List view combined with the Tasks object creates an excellent task queue. Configure:
views:
- name: Today's Tasks
type: list
filters:
- field: Due Date
operator: today
- field: Status
operator: not_equals
value: Complete
sort:
field: Priority
direction: desc
view_settings:
list:
primaryField: Task Name
secondaryField: Related Deal
metaField: Priority
density: compactNow you have a compact, keyboard-navigable task list. Work through it with arrow keys and inline editing — mark tasks complete as you go without ever opening a modal.
Performance: List View for Large Datasets#
List view is the fastest-rendering view for large datasets. Because it shows less information per entry:
- Initial render is fast even for 1,000+ entries
- Virtual scrolling means only visible rows are in the DOM
- Pagination is available for very large datasets
If you have an object with 500+ entries, list view is usually the right choice for initial browsing before drilling down.
List View vs. Table View Decision Guide#
Choose List View when:
- Processing a queue (tasks, follow-ups, reviews)
- Doing bulk updates
- Using keyboard navigation
- Data is on mobile
- You need raw throughput
Choose Table View when:
- Comparing field values across rows
- Sorting and resorting by multiple fields
- Need to see many different field values at once
- Doing analytical review
See also: DenchClaw Gallery View for visual catalog browsing, and DenchClaw Saved Views for combining list view with persistent filters.
Frequently Asked Questions#
Can I pin list view as the default for a specific object?#
Yes. Set default_view: list in the object's .object.yaml, or ask DenchClaw: "Set the default view for Tasks to list view."
Does list view support drag-and-drop reordering?#
Not currently. Drag-and-drop reordering is a planned feature for list view in a future release. Currently, order is determined by your sort configuration.
Can I add more fields to the list view display?#
List view shows up to 2-3 fields per entry by design (for density). For more fields, use table view. You can configure which 2-3 fields are most important for your list view in the view_settings.list configuration.
Is list view good for mobile?#
Yes — list view's compact format translates well to mobile screen sizes. It's the recommended default view for mobile-first usage. The single-line layout with title and subtitle fits naturally within a phone's width.
How do bulk actions work with filtered views?#
Bulk actions only apply to the currently visible/filtered set. If your filter shows 50 out of 500 entries, selecting all and running a bulk action applies to those 50, not all 500. This is by design — filters define your working set.
Ready to try DenchClaw? Install in one command: npx denchclaw. Full setup guide →
