Searching and filtering the candidate database

The candidate list

The Candidate Database lives at the candidate database — every candidate across every job, plus those not attached to any job. Each job's own Candidates tab gives you the same toolbar scoped to that job.

Full-text search

The toolbar has a search box that runs across candidate fields — name, email, phone, current title, employer, skills, and CV body content. Results filter live as you type.

Quick filters (one-click)

Above or alongside the candidate list you'll see preset quick filters. Each is a one-click toggle:

• Top grade — "Show candidates graded A or B by the AI evaluator". Surfaces only the strongest matches per the AI grading.
• With email — "Show only candidates with an email address on file".
• Has notes — "Show candidates with at least one recruiter note".
• Last 7 days — "Show candidates added in the last 7 days".

Detailed filters

Beyond the quick filters, you can filter on:

• Tags — your applied candidate tags.
• Qualifications.
• Top skills — parsed from CV.
• Worked-in cities — locations from past employment.
• Current city / state / country.
• Visa types and visa countries — useful for roles with sponsorship considerations.
• Counters — aggregated counts surface in the UI for quick segmentation.

AI grading

Many of the most useful filters depend on the AI evaluator's grade. Grades range A through D-ish (CVViZ uses grade_in: ['A', 'B'] as an example for "top grade"). Grading is automatic when AI ranking is enabled on a job.

Saved searches

Filter combinations you set persist across pagination via Redux state. When you navigate within the database, your filters stay applied. Clear them via the toolbar's reset / clear button when you want a fresh list.

Sorting

Sort options on the toolbar include grading, recent activity, and other useful axes — see the toolbar's sort dropdown.

List vs card views

The candidate list supports both a card view (visual, kanban-friendly) and a list/table view (denser, easier for bulk operations).

Bulk operations from results

Select candidates in the filtered list (checkbox per row, or "Select all across pages") to:

• Send an email or pre-screening questions.
• Add tags.
• Re-parse resumes.
• Add to another job.
• Export to Excel.
• Delete.

See Bulk actions for the full list.

Tips

• Combine quick filters with text search for fast triage — e.g. "Top grade" + a skill keyword.
• Use Has Notes to find candidates your team has already engaged with.
• Last 7 days is great for daily review of new inflow.
• Top grade won't surface anyone if AI ranking isn't enabled on their job — confirm at the job level if you expected results.