---
title: "GravityBoard filtering guide"
date: 2026-04-23
author: "GravityKit"
link: "https://www.gravitykit.com/docs/gravityboard/gravityboard-filtering-guide/"
---

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

## Table of contents

- [Overview](#overview-oddrm)
- [Quick search](#quick-search-zvw6l)
- [Advanced filtering](#advanced-filtering-zxaz8)
- [Filter types](#filter-types-yhzi8)
- [Combining filters](#combining-filters-pztiq)
- [Sharing filtered views](#sharing-filtered-views-igllx)
- [Keyboard shortcuts](#keyboard-shortcuts-f7uf7)
- [Troubleshooting](#troubleshooting-yyo5j)

## 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=high
```

```
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:

| 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.