Overview
Once a candidate is added to Recruitier — whether through CV upload or LinkedIn import — their profile becomes the foundation for everything that follows: skill confirmation, job matching, pipeline tracking, and outreach. The candidate profile contains over 40 fields covering identity, contact information, skills with confidence scores, location data, preferences, embedding state, and scoring configuration. Keeping profiles accurate and up-to-date directly impacts the quality of AI-generated matches. A candidate’s title influences 35% of the semantic search weight, their skills influence 45%, and their location determines whether jobs are included, penalized, or excluded entirely. This guide covers how to view, edit, search, and manage your candidate profiles.The Candidate List
The candidate list is your primary view for managing all candidates in your account. Access it by navigating to the Candidates section from the main sidebar.What You See
Each candidate in the list displays:- Name — The candidate’s full name (unique per account), with email shown below if available
- Title — Their current or target job title
- Skills — A preview of their top 3 skills as badges, with a “+N” indicator if they have more
- Experience — Experience level (Junior, Medior, Senior, Lead) with years of experience
- Added — The date the candidate was created
- Actions — Download CV button (if a CV file was uploaded) and delete button
Pagination
The candidate list is paginated to keep the interface responsive, even with large candidate pools. You can navigate between pages and control how many candidates are displayed per page. The default page size provides a balance between overview and performance.Active candidates with confirmed skills (
skills_confirmed = true) are the ones that receive the best quality job matches. Candidates without confirmed skills can still receive matches, but the results will be less precise. Look for the status indicator to quickly identify candidates that need skill confirmation.Searching and Filtering Candidates
As your candidate pool grows, finding specific candidates quickly becomes essential. Recruitier provides several search and filter mechanisms.Search
Use the search bar at the top of the candidate list to search by:- Name — Find candidates by first or last name (partial matching supported)
- Title — Search by job title or role description
- Skills — Filter by specific technical or professional skills
Sorting
Sort the candidate list by clicking the column headers:- Name (alphabetical) — Click the Name column header to sort alphabetically
- Date added (newest/oldest first) — Click the Added column header to sort by creation date
The Candidate Detail Page
Click on any candidate to open their full profile. The detail page is organized into several sections that give you a complete view of the candidate and their matching activity.Profile Header
The top section displays the candidate’s core identity:- Full name — The candidate’s name (editable, must be unique within your account)
- Current title — Job title or professional headline
- Location — Geocoded location with normalized city/region display
- Contact information — Email and phone number (if available)
- LinkedIn URL — Link to their LinkedIn profile (if imported from LinkedIn or manually added)
- Experience level — Junior, Medior, Senior, or Lead
- Years of experience — Total professional experience calculated from work history
The experience level and years of experience are calculated during the initial import (either from CV analysis or LinkedIn work history). They are not automatically recalculated when you edit the profile. If you change a candidate’s experience level manually, this change is preserved and used for all subsequent matching.
Skills Section
Displays the candidate’s skills with their management state:- Skill name — The normalized skill (displayed with proper capitalization)
- Confidence score — How certain the AI was about this skill (0.60-0.95+ for CV extraction, 0.80 for LinkedIn import)
- Confirmation status — Whether the skill has been confirmed by a recruiter
skills_confirmed flag on the profile indicates whether the recruiter has completed the skill review process. This flag is the gate for production-quality matching.
See Skills & Expertise for the complete guide to skill management.
Matches Section
The matches section is the main area of the candidate detail page. It includes several features: Stats Bar: When matches exist, a compact stats bar shows aggregate counts: total matches, favorited, applied, and rejected. View Modes: Toggle between two views using the list/kanban buttons:- List view — A scrollable list of matches sorted by score, with full details visible on each card
- Pipeline view — A 4-column Kanban board (New Matches, Favorited, In Progress, Placed) for drag-and-drop workflow management
- New — Show only unreviewed new matches
- Recently Added — Show only matches from the most recent matching run
- Job title with link to the job detail page, plus an external link to the original job posting
- Company name (clickable to view company details), location, experience level, and salary (when available)
- Match score with a color-coded progress bar: green (80%+), yellow (60-79%), red (below 60%)
- AI explanation — Natural language summary of why this match is a good fit
- Key matching points — Green badges highlighting the strongest reasons for the match
- Potential concerns — Orange badges highlighting possible issues to consider
- Action buttons — Favorite/unfavorite, status dropdown (move to any stage), Find Contacts (discover hiring contacts at the company), and reject
CV Download
If the candidate was added via CV upload, you can download the original CV file at any time from the profile page. The file is stored in the database as a LargeBinary field in its original format (PDF, DOCX, or TXT). For LinkedIn-imported candidates, the synthetic CV text is available but there is no downloadable file.Editing a Candidate Profile
Editing Basic Information
You can edit any field on the candidate profile at any time:Open the Candidate Profile
Click on the candidate from the candidate list to open their detail page.
Click Edit
Click the edit button or icon on the section you want to modify. Different sections (identity, location, preferences, skills) have their own edit controls.
Make Your Changes
Update the fields as needed. Common edits include:
- Name — Correct spelling or formatting (must remain unique within your account)
- Title — Update to reflect the candidate’s current target role (this affects the Title vector, 35% of search weight)
- Location — Change if the candidate has relocated or prefers a different area (triggers geocoding and can trigger re-matching)
- Contact details — Add or update email and phone number
- Summary — Add recruiter notes or refine the professional summary
- Experience level — Adjust if the auto-calculated level does not match the candidate’s actual seniority
Editing Location
When you update a candidate’s location, Recruitier automatically geocodes the new address to latitude/longitude coordinates through the GeocodingService pipeline:- Dutch city database — First checks against a comprehensive list of Dutch cities
- Nominatim API — Falls back to the Nominatim geocoding API for locations not in the Dutch database
- AI normalization — Uses AI-based normalization for ambiguous or non-standard location strings
Changing a candidate’s location, latitude, longitude, or preferred search radius triggers an automatic re-match. The system recognizes that these changes affect which jobs are geographically relevant and runs the matching pipeline with the updated parameters. Protected matches (favorited, applied, contacted, interviewing, offer stage, placed) are preserved during re-matching.
Editing Skills
Skills can be added, removed, or modified from the candidate’s profile at any time. The system uses intelligent change detection:- Skills are compared case-insensitively and order-independently
- “Python” and “python” are considered the same skill
- Reordering skills without adding or removing any does not count as a change
- Only actual additions or removals are detected as changes
exclude_job_ids for protected matches, ensuring your pipeline progress is preserved.
See Skills & Expertise for the complete guide to skill management.
Editing Scoring Weights
Each candidate has four configurable scoring weights that control how the AI scoring dimensions are combined:| Weight | Default | Purpose |
|---|---|---|
weight_skills | 0.35 | How much skills fit matters in the final score |
weight_role | 0.30 | How much role fit matters |
weight_experience | 0.20 | How much experience fit matters |
weight_secondary | 0.15 | How much secondary factors matter |
Deleting a Candidate
If you need to remove a candidate from your account:- Open the candidate’s profile
- Click the Delete option
- Confirm the deletion
Duplicate Name Detection
Recruitier prevents you from having two candidates with the exact same name within your account. If you try to create or rename a candidate to a name that already exists, you receive a conflict error. This is a safeguard to prevent confusion in your candidate pool. The duplicate check is case-sensitive, so “Jan de Vries” and “jan de vries” are technically different, but we recommend keeping names consistently formatted.Candidate Limits by Plan
The number of active candidates you can maintain depends on your subscription plan:| Plan | Candidate Limit | Notes |
|---|---|---|
| Free | 3 candidates | Best for trying the platform before upgrading |
| Pro | Unlimited | Full access, even during trial period |
| Agency | Unlimited | Full access with additional agency features |
Pro and Agency users have unlimited candidates even during a trial period. Only the Free plan enforces candidate limits. If you reach the Free tier limit of 3 candidates, you need to upgrade or deactivate existing candidates before adding new ones.
Best Practices
Keep Profiles Current
When a candidate updates their CV, gains a new certification, changes their job preferences, or relocates, update their Recruitier profile. Outdated information leads to irrelevant matches. A profile update can trigger re-matching that surfaces new opportunities.
Use Consistent Naming
Adopt a naming convention for your candidates (e.g., always “First Last” without titles like “Mr.” or “Ir.”). This makes searching and sorting more reliable across your entire candidate pool.
Add Context in the Summary
The summary field is not just for the candidate’s own words. Use it to add recruiter notes: availability dates, preferred company sizes, deal-breakers, interview notes, or special considerations. This context helps you remember details that the AI cannot infer from the CV.
Verify High-Impact Fields First
When reviewing a profile, prioritize verifying the title (35% of search weight), skills (45% of search weight), and experience level before spending time on cosmetic edits. These three fields have the biggest impact on match quality.
Advanced
How Profile Changes Trigger Re-Matching
Not all profile changes are equal. The system tracks specific fields and uses change detection logic to determine when re-matching is warranted:Fields That Trigger Re-Matching
Fields That Trigger Re-Matching
The following changes are detected as re-match triggers:
- Skills — Adding, removing, or changing confirmed skills (case-insensitive, order-independent comparison)
- Location — Changing the location string
- Latitude/Longitude — Changing the geocoded coordinates
- Preferred radius — Changing the search radius in km
exclude_job_ids for protected matches to avoid creating duplicates.Fields That Do NOT Trigger Re-Matching
Fields That Do NOT Trigger Re-Matching
Changes to these fields update the profile but do not trigger automatic re-matching:
- Name, email, phone number
- Summary text
- LinkedIn URL
- Scoring weights (these affect how scores are calculated, but require a manual re-match to apply)
- Salary expectations
- Job type preferences
- Flexibility preferences
The Re-Matching Process
The Re-Matching Process
When re-matching is triggered:
- The system loads all existing matches for the candidate
- Protected matches (any status except “pending”) are identified
- The job IDs of protected matches are collected into an exclude list
- The full 5-stage matching pipeline runs with the updated profile
- New matches are added alongside existing protected matches
- Old pending matches that are no longer relevant may be replaced
The Candidate Entity Data Model
Each candidate profile contains a rich set of fields organized by purpose: Identity fields:name (required, unique per account), email, phone, linkedin_url
Professional fields: title, summary, experience_level (junior/medior/senior/lead), years_of_experience, education_level
Skills fields: skills (JSONB array of skill names), skills_with_confidence (JSONB array of {"name": "Python", "confidence": 0.95, "confirmed": false}), skills_confirmed (boolean gate for matching quality)
Location fields: location (display string), latitude, longitude, normalized_location
Preferences fields: preferred_job_types (JSONB), preferred_flexibility (JSONB), preferred_locations (JSONB), preferred_radius, salary_expectation_min, salary_expectation_max
CV data: cv_text (up to 50,000 characters), cv_file (LargeBinary, original uploaded file)
Scoring configuration: weight_skills (0.35), weight_role (0.30), weight_experience (0.20), weight_secondary (0.15)
Embedding state: is_embedded (boolean), embedded_at (timestamp)
How Candidate Data Flows Through the Platform
Understanding the data flow helps you make better decisions about what to prioritize when managing profiles:- Title flows to the Title vector embedding (35% of semantic search weight) and influences role fit scoring
- Skills flow to the Skills vector embedding (45% of search weight) and drive skills fit scoring. Only confirmed skills are used for scoring.
- CV text flows to the Experience vector embedding (20% of search weight) and is sent to AI scoring (up to 8,000 chars)
- Location + radius controls geographic filtering (within radius = full score, 1x-2x = penalty, beyond 2x = excluded)
- Scoring weights control how the four AI dimensions are combined into the final score
- Preferences (job type, flexibility) are applied as filters during the vector search stage
Power-User Tips
Candidate deletion is a soft delete by design. If you accidentally delete a candidate, the data is still in the database and can be recovered. Contact support if you need to restore a deleted candidate profile.
Related
- Skills & Expertise — Confirm and manage candidate skills
- Location & Preferences — Configure matching preferences
- Candidate Pipeline — Track candidates through your workflow
- How Matching Works — Understand what drives match quality