## Overview

Shows at a glance results for a defined search.

The Quick Overview widget creates dashboard-style summary tiles that combine statistical counts with quick access links. Each tile displays a configurable header (title, subtitle, icon), the total number of matching items, and a limited list of specific results. An optional create button enables users to add new items without navigating away from the landing page.

This widget is part of the Landing Page from Page plugin, which enables creating landing pages within any workspace that display without the standard workspace navigation chrome.

## Use Cases

### Landing Page Dashboard Tiles
Create at-a-glance summaries for different content categories on landing pages. Examples include:
- "5 Active Projects" showing the first 3 project names with links
- "12 Open Tasks" displaying the first 5 task titles
- "8 Team Members" with quick access to member profiles

### Content Category Overview
Provide users with immediate visibility into filtered content distributions without requiring navigation to full search results or list pages. The prominent count display helps users understand content volume at a glance.

### Quick Navigation Hubs
Build clickable entry points to frequently accessed content, combining summary statistics with direct item access. Users can quickly jump to specific items or use the create button to add new ones.

## Design Considerations

### When to Use This Widget
Choose Quick Overview when:
- You need a compact summary tile format with prominent count display
- The hit count is as important as the items themselves
- You want to show a limited preview (typically 3-7 items) of a larger collection
- Users need quick access to both item details and creation functionality

### Alternatives to Consider

**Simple List Overview** (`cf.cplace.landingPageFromPage.simpleListWithAttachment`)
- Choose when you need subtitles for each item (via pattern formatting)
- Better for scrollable lists with custom per-item icons based on enum attributes
- Supports linking to an overview page
- Does not display prominent hit counts

**Connected Table** (`cf.platform.connectedTable` or similar table widgets)
- Choose when users need comprehensive data with sorting, filtering, and selection
- Better for detailed data exploration rather than quick summaries
- Supports more complex interactions and master-detail patterns

### Key Differentiators
- **Hit count prominence**: The total count is a primary visual element, not supplementary information
- **Limited item display**: Intentionally shows only a subset of results for compact dashboard presentation
- **Create button integration**: Supports in-context item creation without leaving the landing page
- **Tile format**: Designed as a self-contained summary card rather than a full-width list or table

## Common Pitfalls

### Search Configuration Issues
The widget requires a properly configured search that targets content appropriately. When multiple workspaces are selected in the search, the space filter is automatically removed, which may produce unexpected results.

### Create Button Limitations
The create button functionality works best when the search targets a single workspace and single type. Multi-type or multi-workspace searches may not provide the expected create behavior.

### Sort Behavior
The widget applies alphabetical sorting (ascending or descending) regardless of the configured sort column. This ensures consistent item ordering but may differ from the original search result ordering.

## Related Patterns

**Landing Page Design Pattern**: Combine multiple Quick Overview widgets on a single landing page to create a comprehensive dashboard showing different content categories, each with its own count and preview items.

**Progressive Disclosure**: Use Quick Overview tiles as entry points, where clicking items leads to detail pages, or use the overview page link pattern (available in Simple List Overview) to navigate to comprehensive filtered views.