Skip to main content
Troubleshooting
Updated Aug 13, 2026

Candidate Import & Data Issues

File format — ensure the resume is PDF, DOC, or DOCX. Other formats are not supported. File size — resumes over 10MB may fail. Ask the candidate to co

# Candidate Import & Data Issues ## Resume Parsing Problems ### Parsing Failed - **File format** — ensure the resume is PDF, DOC, or DOCX. Other formats are not supported. - **File size** — resumes over 10MB may fail. Ask the candidate to compress the file. - **Scanned documents** — scanned PDFs without text layers may have limited extraction. OCR quality varies. - **Unusual formatting** — heavily designed resumes (infographics, multi-column layouts) may not parse correctly. ### Missing Data After Parsing AI parsing extracts what it can find. If fields are missing: - The information may not be present in the resume. - The formatting may have made it undetectable. - Manually add missing information to the candidate profile. ## Duplicate Candidates ### Automatic Detection HireBee checks for duplicates based on email address when: - A candidate applies to a job. - You manually add a candidate. - You import candidates in bulk. ### Merging Duplicates If duplicates are found: 1. Go to **Candidates → Duplicates** (or you'll be prompted during import). 2. Review the duplicate pairs. 3. Choose the primary record to keep. 4. Click **Merge** — data from the secondary record is combined into the primary. 5. Applications, notes, and communications are preserved from both records. ## Bulk Import Issues ### Import Stuck or Failed - Check the import job status in **Candidates → Import History**. - Large imports (50+ files) may take several minutes. - If an import fails, individual file errors are listed — fix and retry. ### Data Mapping When importing CSV data: - Column headers must match expected fields (name, email, phone, etc.). - Email is the only required field. - Unknown columns are ignored.

Have questions? We're here to help

Get personalized guidance from our HR technology experts.