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:
- Click the search boxย in the toolbar or pressย
/ - Type your keywords
- 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:
- Click the filter buttonย (funnel icon) in the toolbar
- The filter popover appears with all options
- Set your criteriaย (see Filter Types below)
- 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:
- Click “Select assignees”ย dropdown
- Check usersย to include
- Multiple selection: Cards with ANY selected user appear
- 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:
- Toggle completion filters:
- Show only cards with completed checklists
- Show only cards with incomplete checklists
- Show all (default)
- Keyword search: Find cards with specific checklist items
- 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
- Apply your filters
- Copy the URLย from your browser
- Share the linkย with team members
- They see the exact same filtered view
URL Parameters
Example URL with filters:
https://yoursite.com/board/#keyword=urgent&assignees=1,4&labels=highUse 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:
| Shortcut | Action |
|---|---|
/ | Focus search box |
Shift+Esc | Clear all filters |
Escape | Close filter popover |
Tab | Navigate filter fields |
Note:ย Board must have focus for shortcuts to work.
Troubleshooting #
Filters not working
No results showing:
- Check if filters are too restrictive
- Try removing filters one by one
- Ensure cards actually match criteria
All cards still showing:
- Verify filters are applied (check URL)
- Refresh the page
- Check filter indicator shows active count
Need help with specific filtering scenarios? Check our other guides or contact support.