GravityBoard filtering guide

Learn how to filter and search your GravityBoard to quickly find the cards you need.

Table of contents

• Overview
• Quick search
• Advanced filtering
• Filter types
• Combining filters
• Sharing filtered views
• Keyboard shortcuts
• Troubleshooting

Overview

GravityBoard's filtering system helps you focus on specific cards by hiding those that don't match your criteria. Filters work across all lanes and can be combined for powerful searches.

Key features

• Multiple filter types: Keyword, assignee, label, date, and checklist filters
• Real-time filtering: Results update instantly as you type
• URL persistence: Share filtered views with team members
• Visual indicators: See how many filters are active
• Quick clear: Remove all filters with one click or keyboard shortcut

Quick Search

The fastest way to filter cards is using the search box:

1. Click the search box in the toolbar or press /
2. Type your keywords
3. Cards are filtered in real-time as you type

What gets searched

• Card titles
• Card descriptions
• Any text visible on the card face

Search tips

• Case-insensitive: Searches ignore case
• Partial matches: "proj" matches "project" and "projection"
• Multiple words: All words must be present (AND logic)
• No special syntax: Just type naturally

Advanced filtering

For more control, use the filter popover:

1. Click the filter button (funnel icon) in the toolbar
2. The filter popover appears with all options
3. Set your criteria (see Filter Types below)
4. Click outside to apply filters

Filter popover sections

• Keyword: Text search across cards
• Assignees: Filter by assigned users
• Labels: Filter by label field values
• Due Date: Filter by date ranges
• Checklists: Filter by checklist completion

Filter types

Keyword filter

Search for text within cards:

• Location: Top of filter popover
• Searches: Titles and descriptions
• Behavior: Case-insensitive partial matching
• Example: "urgent" finds all cards containing "urgent" anywhere

Assignee filter

Filter by assigned users:

1. Click "Select assignees" dropdown
2. Check users to include
3. Multiple selection: Cards with ANY selected user appear
4. Unassigned option: Find cards with no assignees

Tips:

• Select multiple users to see cards assigned to any of them
• Combine with other filters to narrow results
• User avatars help identify assignees quickly

Checklist Filter

Filter by checklist status:

1. Toggle completion filters:
   • Show only cards with completed checklists
   • Show only cards with incomplete checklists
   • Show all (default)
2. Keyword search: Find cards with specific checklist items
3. Combined: Use both completion status and keywords

Examples:

• "Show incomplete" + keyword "design" = Cards with incomplete checklists containing "design"
• "Show completed" only = All cards with 100% complete checklists

Combining filters

Filters work together using AND logic.

Example combinations

Project manager view:

• Assignee: "John Doe"
• Label: "High Priority"
• Due Date: "This Week"
• Result: John's high-priority cards due this week

Sprint planning:

• Keyword: "sprint"
• Checklist: "Incomplete"
• Label: "Development"
• Result: Development cards mentioning "sprint" with incomplete tasks

Client review:

• Keyword: "client name"
• Due Date: "Next 7 days"
• Assignee: "Any team member"
• Result: All client cards due soon assigned to anyone

Sharing filtered Views

Filters are automatically saved in the URL, making it easy to share views.

How it works

1. Apply your filters
2. Copy the URL from your browser
3. Share the link with team members
4. They see the exact same filtered view

URL Parameters

Example URL with filters:

https://yoursite.com/board/#keyword=urgent&assignees=1,4&labels=high

Use cases

• Daily Standup: Share "My tasks today" view
• Sprint Review: Share "Completed this sprint" view
• Client Updates: Share filtered view of their projects
• Team Focus: Share "Urgent items" view

Keyboard shortcuts

Speed up filtering with keyboard shortcuts:

Note: Board must have focus for shortcuts to work.

Troubleshooting

Filters not working

No results showing:

1. Check if filters are too restrictive
2. Try removing filters one by one
3. Ensure cards actually match criteria

All cards still showing:

1. Verify filters are applied (check URL)
2. Refresh the page
3. Check filter indicator shows active count

Need help with specific filtering scenarios? Check our other guides or contact support.