Using the Global Search Feature

# Using the Global Search Feature

## Overview

The Global Search is your command centre for navigating the Social Home dashboard. Located in the header of every admin page, this powerful search bar lets you instantly find any entity in your system—from properties and tenants to maintenance requests, messages, emails, compliance items, and more.

<strong>Key Benefits:</strong> - ⚡ <strong>Instant Results</strong>: Real-time search with results appearing as you type - 🎯 <strong>Comprehensive Coverage</strong>: Searches across 10 different entity types - ⌨️ <strong>Keyboard Shortcuts</strong>: Quick access with ⌘K (Mac) or Ctrl+K (Windows/Linux) - 📱 <strong>Smart Organization</strong>: Results grouped by category for easy scanning - ♿ <strong>Fully Accessible</strong>: Complete keyboard navigation and screen reader support

## Getting Started

### Accessing the Search Bar

The search bar is always visible in the header of your dashboard (desktop only):

1. <strong>Click the search field</strong> in the top centre of your screen 2. <strong>Or use the keyboard shortcut</strong>: Press `⌘K` (Mac) or `Ctrl+K` (Windows/Linux) 3. The search input will focus and you can start typing immediately

### Basic Search

1. <strong>Type your search query</strong> (minimum 2 characters) 2. <strong>Results appear automatically</strong> as you type 3. <strong>Browse grouped results</strong> organised by category 4. <strong>Click any result</strong> to navigate directly to that item 5. <strong>Press Escape</strong> or click outside to close the dropdown

### Search Capabilities

The search bar searches across these entity types:

#### 🏠 <strong>Properties</strong> - <strong>Search by</strong>: Property name, address, postcode - <strong>Results show</strong>: Property name, address, status - <strong>Navigates to</strong>: Property detail page

#### 👥 <strong>Tenants</strong> - <strong>Search by</strong>: Tenant name, email address, phone number - <strong>Results show</strong>: Tenant name, contact info, rent status - <strong>Navigates to</strong>: Tenant profile page

#### 🔧 <strong>Maintenance Requests</strong> - <strong>Search by</strong>: Work order title, description - <strong>Results show</strong>: Title, priority, status, category - <strong>Navigates to</strong>: Maintenance request details

#### 💬 <strong>Messages/Conversations</strong> - <strong>Search by</strong>: Conversation title, message content - <strong>Results show</strong>: Conversation title, last message preview - <strong>Navigates to</strong>: Conversation thread

#### 📧 <strong>Emails</strong> - <strong>Search by</strong>: Email subject, sender, recipient - <strong>Results show</strong>: Subject line, sender/recipient info - <strong>Navigates to</strong>: Email details

#### 📞 <strong>Calls</strong> - <strong>Search by</strong>: Caller name, recipient, call notes - <strong>Results show</strong>: Call direction, participants, date - <strong>Navigates to</strong>: Call log details

#### 🛡️ <strong>Compliance Items</strong> - <strong>Search by</strong>: Certificate type, notes - <strong>Results show</strong>: Compliance type, status, due date - <strong>Navigates to</strong>: Compliance certificate page

#### 📄 <strong>Documents</strong> - <strong>Search by</strong>: Filename, document description - <strong>Results show</strong>: Filename, document type - <strong>Navigates to</strong>: Document viewer

#### 📊 <strong>Financial Reports</strong> - <strong>Search by</strong>: Report type - <strong>Results show</strong>: Report type, date range - <strong>Navigates to</strong>: Report viewer

#### ✅ <strong>Tasks</strong> - <strong>Search by</strong>: Task title, description - <strong>Results show</strong>: Task title, priority, status - <strong>Navigates to</strong>: Task details

## Keyboard Navigation

### Quick Access Shortcuts

| Shortcut | Action | |----------|--------| | `⌘K` or `Ctrl+K` | Focus search bar from anywhere | | `↑` Arrow Up | Navigate to previous result | | `↓` Arrow Down | Navigate to next result | | `Enter` | Open the selected result | | `Escape` | Close the dropdown |

### Navigation Flow

1. <strong>Press</strong> `⌘K` <strong>to focus</strong> the search field 2. <strong>Type your query</strong> (e.g., "John Smith" or "123 High Street") 3. <strong>Use arrow keys</strong> to highlight different results 4. <strong>Press Enter</strong> to open the highlighted result 5. <strong>Or press Escape</strong> to close and continue working

### Power User Tips

- <strong>Start typing immediately</strong> after pressing ⌘K—no need to click - <strong>Use arrow keys</strong> instead of mouse for faster navigation - <strong>Results are grouped</strong>—use Down arrow to skip between categories - <strong>First result is auto-selected</strong>—just press Enter if it's correct - <strong>Clear search with X button</strong> or start typing a new query

## Understanding Search Results

### Result Display Format

Each search result shows:

1. <strong>Icon & Colour</strong>: Visual indicator of entity type - 🏠 Blue: Properties - 👥 Purple: Tenants - 🔧 Orange: Maintenance - 💬 Green: Messages - 📧 Indigo: Emails - 📞 Teal: Calls - 🛡️ Red: Compliance - 📄 Gray: Documents - 📊 Cyan: Reports - ✅ Pink: Tasks

2. <strong>Title</strong>: Primary identifier (property name, tenant name, etc.)

3. <strong>Subtitle</strong>: Additional context (address, email, description)

4. <strong>Status Badges</strong>: Quick status indicators - Rent status (current/arrears) - Priority (low/medium/high/urgent) - Completion status - Compliance status

5. <strong>Category Header</strong>: Shows how many results in each category - Example: "Properties (3)" or "Tenants (5)"

### Results Limit

- <strong>Maximum 5 results per category</strong> displayed - <strong>50 total results maximum</strong> across all categories - Most relevant results shown first - Exact matches prioritized over partial matches

### No Results Found

If no results are found: - Check your spelling - Try broader search terms - Search with fewer words - Try searching by ID, name, or address instead of full details

## Advanced Search Techniques

### Search Best Practices

#### <strong>Be Specific</strong> - ❌ Don't: "property" - ✅ Do: "123 High Street" or "Flat A"

#### <strong>Use Identifying Information</strong> - Properties: Address or postcode - Tenants: Name, email, or phone number - Maintenance: Work order title or property address - Documents: Filename or description keywords

#### <strong>Partial Matching</strong> - Search works with partial text - "High Street" finds "123 High Street, London" - "john@" finds "john@example.com" - "plumb" finds "Plumbing Emergency" and "Plumber Visit"

### Common Search Scenarios

#### <strong>Finding a Tenant</strong> ``` Search: "john" or "john@email.com" or "+44 7700" Results: All tenants matching name, email, or phone ```

#### <strong>Finding a Property</strong> ``` Search: "SW1A" or "123 High" or "Oak House" Results: Properties matching postcode, address, or name ```

#### <strong>Finding Maintenance Issues</strong> ``` Search: "boiler" or "leak" or "urgent repair" Results: Maintenance requests with matching titles/descriptions ```

#### <strong>Finding a Conversation</strong> ``` Search: tenant name or message content Results: Conversations containing that information ```

#### <strong>Finding Documents</strong> ``` Search: "lease" or "certificate" or filename Results: Documents matching filename or description ```

## Accessibility Features

### Screen Reader Support

The global search is fully accessible to screen readers with:

- <strong>ARIA Labels</strong>: All interactive elements properly labeled - <strong>Role Attributes</strong>: Combobox and listbox roles for proper semantics - <strong>Live Regions</strong>: Result updates announced to screen readers - <strong>Keyboard Focus</strong>: Clear focus indicators and tab order

### Keyboard-Only Navigation

Complete functionality without a mouse:

1. <strong>Tab</strong> to reach search bar (or use ⌘K shortcut) 2. <strong>Type</strong> your query 3. <strong>Arrow keys</strong> to navigate results 4. <strong>Enter</strong> to select 5. <strong>Escape</strong> to close

### High Contrast Mode

All visual elements support high contrast mode: - Clear focus indicators - Sufficient color contrast (WCAG AA compliant) - Pattern-based status indicators (not color-only)

## Performance & Speed

### Real-Time Results

- <strong>300ms debounce</strong>: Search waits 300ms after you stop typing before querying - <strong>Cancels previous requests</strong>: Only the latest query runs - <strong>Parallel execution</strong>: All searches run simultaneously for speed - <strong>Cached results</strong>: Recent searches load faster (60-second cache)

### Loading States

While searching, you'll see: - <strong>Loading spinner</strong> in the dropdown - <strong>"Searching..." message</strong> - Results appear within 1-2 seconds typically

## Troubleshooting

### Search Not Working

<strong>Problem</strong>: "I type but no results appear" - <strong>Check</strong>: Are you typing at least 2 characters? - <strong>Solution</strong>: Queries shorter than 2 characters don't trigger search - <strong>Verify</strong>: Check your internet connection

<strong>Problem</strong>: "Search bar is not visible" - <strong>Check</strong>: Are you on mobile or tablet? - <strong>Solution</strong>: Global search is desktop-only currently - <strong>Alternative</strong>: Use individual page filters on mobile

### No Results Found

<strong>Problem</strong>: "Search shows 'No results found'" - <strong>Check</strong>: Spelling and search terms - <strong>Try</strong>: Broader search queries - <strong>Example</strong>: Search "John" instead of "John Smith" - <strong>Verify</strong>: The item exists in your company's data

<strong>Problem</strong>: "I can see the item in a list but search doesn't find it" - <strong>Possible causes</strong>: - Item belongs to a different company - Item was archived or deleted - Database indexing delay (rare) - <strong>Solution</strong>: Wait a few seconds and try again

### Dropdown Issues

<strong>Problem</strong>: "Dropdown won't close" - <strong>Solution</strong>: Click outside the dropdown area - <strong>Or</strong>: Press the Escape key - <strong>Or</strong>: Click the X button to clear search

<strong>Problem</strong>: "Can't navigate with keyboard" - <strong>Check</strong>: Is the dropdown open and visible? - <strong>Solution</strong>: Ensure search input has focus - <strong>Try</strong>: Click search field first, then use arrow keys

### Performance Issues

<strong>Problem</strong>: "Search is slow or unresponsive" - <strong>Check</strong>: Number of entities in your system - <strong>Solution</strong>: - Use more specific search terms - Check internet connection speed - Try clearing browser cache - <strong>Report</strong>: Contact support if persistent

## Privacy & Security

### Data Protection

- <strong>Company-scoped</strong>: You only see data from your company - <strong>Role-based access</strong>: Search respects your permissions - <strong>Secure connection</strong>: All searches use encrypted HTTPS - <strong>No logging</strong>: Search queries are not permanently stored

### What You Can/Cannot Search

<strong>✅ You Can Search:</strong> - Any data your role has permission to view - All entities within your company - Archived and active items

<strong>❌ You Cannot Search:</strong> - Data from other companies - Items you don't have permission to view - Deleted or permanently removed items

## Tips for Maximum Efficiency

### Daily Usage Patterns

<strong>Morning Check-In:</strong> - Press ⌘K, search "arrears" to check rent issues - Search specific tenant names for follow-ups - Check "urgent" maintenance requests

<strong>Quick Navigation:</strong> - Use search instead of clicking through menus - Faster than navigating sidebar → section → item - Bookmark frequently accessed items by searching them

<strong>Task Management:</strong> - Search "overdue" or "urgent" for priorities - Find specific work orders by property address - Locate tenant communications quickly

### Integration with Workflow

<strong>Property Management:</strong> 1. Search property address 2. View property details 3. Check related tenants and maintenance 4. Access compliance certificates

<strong>Tenant Support:</strong> 1. Search tenant name 2. View tenant profile 3. Check case file entries 4. Review communication history

<strong>Maintenance Coordination:</strong> 1. Search work order keywords 2. View maintenance details 3. Check property and tenant info 4. Update work order status

## Mobile App Alternative

While global search is currently desktop-only, mobile users can:

- <strong>Use page-specific search</strong>: Each page has its own search/filter - <strong>Navigate via menus</strong>: Sidebar and bottom navigation - <strong>Use recent items</strong>: Quick access to recently viewed entities - <strong>Filter lists</strong>: Use filter buttons on each listing page

## Future Enhancements

### Coming Soon

- 📱 <strong>Mobile Support</strong>: Global search on mobile devices - 🎯 <strong>Saved Searches</strong>: Save frequently used queries - 📋 <strong>Search History</strong>: Access your recent searches - 🔮 <strong>Smart Suggestions</strong>: Auto-complete based on your usage - 🏷️ <strong>Advanced Filters</strong>: Filter results by date, status, priority - 💡 <strong>Search Tips</strong>: Contextual help and examples - 📊 <strong>Search Analytics</strong>: See what you search most often

### Planned Features

- <strong>Fuzzy Matching</strong>: Find results even with typos - <strong>Quick Actions</strong>: Edit or delete directly from search results - <strong>Bulk Selection</strong>: Select multiple results for batch actions - <strong>Export Results</strong>: Export search results to CSV - <strong>Search Operators</strong>: Use "AND", "OR" for complex queries

## Getting Help

### Support Resources

If you need assistance with global search:

<strong>📚 Documentation</strong> - This guide covers all features and troubleshooting - Check related guides for entity-specific help

<strong>💬 In-App Support</strong> - Click the help icon in the header - Use the chat widget for live support

<strong>📧 Email Support</strong> - Email: support@social-home.co.uk - Include screenshots if reporting issues

<strong>💬 Contact Form</strong> - Reach us any time via our [contact form](/contact) - Responses Monday-Friday, 9am-5pm GMT

### Feedback & Suggestions

We're continuously improving the search feature. Please share:

- <strong>Feature Requests</strong>: What else should be searchable? - <strong>Usability Feedback</strong>: How can we make it easier? - <strong>Bug Reports</strong>: Anything not working as expected? - <strong>Performance Notes</strong>: Is it fast enough for your needs?

Contact us at product@social-home.co.uk with your feedback.

## Conclusion

The Global Search feature is designed to save you time and improve your daily workflow. By mastering the keyboard shortcuts and search techniques in this guide, you can navigate your property management dashboard with unprecedented speed and efficiency.

<strong>Remember:</strong> Press ⌘K anytime to start searching—it's your fastest path to any information in the system.