Find Candidates
The Find Candidates tab helps recruiters source candidates from the database for specific jobs using AI-powered search filters.
Overview
When you open a job's Find Candidates tab, VoiceHire automatically analyzes the job requirements and generates search filters to find matching candidates. You can browse results, refine filters, and add candidates directly to the job's pipeline.
Required permission: Super Admin/Admin org role, or the manageCandidates capability
How It Works
- Navigate to a job and click the Find Candidates tab
- VoiceHire analyzes the job description, requirements, skills, and specifications
- AI generates relevant search filters (skills, location, experience level, etc.)
- Candidates appear in a searchable table with match scores
- Select candidates and click Add to Pipeline to add them to this job
The job is automatically pre-selected when adding candidates to the pipeline from this tab.
Opening Find Candidates
The Find Candidates tab appears in the job navigation bar.
Click Find Candidates to open the candidate sourcing interface.
AI Filter Generation
When you first open the tab, you'll see:
Analyzing job requirements...
Generating search filters from "{Job Title}"
This takes a few seconds as the AI analyzes:
- Job title and description
- Required and preferred skills
- Experience level
- Location and location type
- Department and role type
- Custom job specifications
Auto-Generated Filters
AI creates filters based on job requirements. Filters appear as chips below the search bar.
Example Filter Generation
For a job titled "Senior React Developer - Remote" with requirements for React, TypeScript, 5+ years experience:
| Generated Filter | Mode | Source |
|---|---|---|
| Technical Skills contains React | Required | Job requirements |
| Technical Skills contains TypeScript | Preferred | Job description |
| Total Experience ≥ 60 months | Preferred | Experience level |
| Location Type equals Remote | Required | Job location type |
Filter Modes
Each generated filter is assigned one of two modes:
| Mode | Behavior | Example |
|---|---|---|
| Required | Hard filter — excludes non-matching candidates | Location, Status |
| Preferred | Soft filter — contributes to match score | Specific skills, experience range |
See Searching Candidates for details on filter modes.
Search and Filtering
Once filters are generated, you can use all standard search features:
Text Search
Type in the search bar to search by name, email, title, company, or skills. Text search works alongside auto-generated filters.
AI Mode
Click Ask AI to add additional filters in natural language. This supplements the auto-generated filters rather than replacing them.
Example: "Also show candidates who know Node.js"
Manual Filters
Click Add Filter to manually add more criteria:
- Select a field (e.g., Current Salary, Notice Period, Education)
- Choose an operator (Equals, Greater Than, Contains, etc.)
- Enter a value
- Choose Required or Preferred mode
- Click Add Filter
Managing Filters
- Edit — Click the edit icon on any filter chip
- Remove — Click the X icon to remove a filter
- Toggle — Use the switch to temporarily disable a filter
- Clear All — Remove all filters and start fresh
You can modify or remove auto-generated filters. The AI doesn't re-run when you edit filters — changes persist until you refresh the page.
Results Table
The results table shows candidates matching your search and filters.
Columns
| Column | Information | Sortable |
|---|---|---|
| Checkbox | Select candidates for bulk add | No |
| Name | Full name, current title, match score badge | Yes |
| Email address | Yes | |
| Company | Current employer | Yes |
| Location | City, State, Country | No |
| Notice Period | Availability | Yes |
| Current Salary | Current compensation | Yes |
| Expected Salary | Salary expectation | Yes |
| Owner | Assigned recruiter | Yes |
| Applications | Number of job applications | Yes |
| Status | Active, Archived, Do Not Contact | Yes |
| Created | When candidate was added | Yes |
Match Scores
When preferred filters are active, each candidate shows a match score badge:
| Score | Color | Meaning |
|---|---|---|
| 100% | Green | Matches all preferred criteria |
| 50-99% | Blue | Matches most preferred criteria |
| <50% | Orange | Matches some preferred criteria |
Hover over the badge to see which criteria the candidate matched.
Sorting
Click column headers to sort results. When preferred filters are active, sorting by Name automatically sorts by match score (highest first).
Adding Candidates to Pipeline
Select one or more candidates and click Add to Pipeline to add them to the job's hiring pipeline.
Steps
- Check the boxes next to candidates you want to add
- Click Add to Pipeline in the action bar
- Confirm the job selection (pre-selected to the current job)
- Optionally add notes for all candidates
- Optionally choose to skip candidates who already have applications for this job
- Click Add to Pipeline
Bulk Add Dialog
The dialog shows:
- Job Position — Pre-selected to the current job (you can change it)
- Note — Optional note added to all new applications
- Skip existing applications — Checkbox to skip candidates who already applied
The current job is automatically pre-selected in the "Add to Pipeline" dialog. You can still select a different job if needed.
What Happens
When you add candidates to the pipeline:
- A new application is created for each candidate
- Applications start in the first pipeline stage
- Candidates receive an email notification (if email templates are configured)
- You're redirected to the job's Applications view
If a candidate already has an application for this job:
- With Skip existing checked → That candidate is skipped
- With Skip existing unchecked → A duplicate application is created
Refreshing Filters
To regenerate filters from the job:
- Refresh the browser page
- The AI will re-analyze the job and generate fresh filters
This is useful after editing the job description or requirements.
Use Cases
Proactive Sourcing
After creating a new job, open Find Candidates to immediately see matching candidates from your database before waiting for applications.
Filling Pipeline Gaps
If a job isn't getting enough applicants, use Find Candidates to source existing candidates who match the requirements.
Reviewing Past Applicants
Find candidates who applied to similar jobs in the past. Combine auto-generated filters with manual filters like "Applications ≥ 1" or "Status equals Archived".
Building Diverse Pipelines
Use the auto-generated filters as a starting point, then adjust to broaden or narrow criteria. Toggle filters on/off to explore different candidate pools.
Permissions
| Action | Required |
|---|---|
| View Find Candidates tab | Super Admin/Admin, or manageCandidates capability |
| Search and view candidates | Same as above |
| Add candidates to pipeline | Same as above |
Related
- Searching Candidates - Detailed search and filter guide
- Candidate Profile - Adding candidates to jobs
- Applications - Managing the job pipeline
- AI Configuration - Job-level AI settings