Workable parsing errors slow you down and frustrate your clients. Candidates' CVs come through scrambled, missing key info, or with broken formatting. You need a quick way to spot the cause and fix it—without wasting time on trial and error.
TL;DR: Workable mangles CVs mainly because of tables, complex layouts, and non-standard fonts. The fix is removing or simplifying these elements before upload. Use the 60-second decision tree below to diagnose the issue fast. If you send 20+ CVs weekly, Distill can auto-clean them to Workable's spec in 30 seconds.
Quick diagnosis: What’s breaking Workable’s parser?
Use this decision tree to identify the root problem quickly:
| Issue observed | Likely cause | Quick test |
|---|---|---|
| Contact details missing or scrambled | Tables or text boxes around info | Copy-paste contact details into Notepad. If messy, it’s tables/text boxes |
| CV formatting is broken or jumbled | Complex tables or columns | Remove all tables and columns, upload again |
| Sections merged or out of order | Incorrect heading styles | Check if headings use built-in Word styles (Heading 1, 2, etc.) |
| Special characters replaced or lost | Unsupported fonts or encoding | Change font to Arial or Calibri, re-upload |
| PDF upload fails or strips text | PDF is image-based or protected | Convert PDF to Word, run OCR if needed |
If you identify the issue in the test, proceed with the relevant fix below. If not, jump to "When to escalate to Distill" for a faster solution.
Root causes of Workable CV parsing errors (ranked by frequency)
Tables and text boxes around key info Workable's parser can't read tables or text boxes cleanly. Contact details or job history inside tables often vanish or jumble on upload.
Multiple columns and complex layouts Two- or three-column CVs confuse the parser. It reads left to right, top to bottom, merging text incorrectly.
Non-standard or decorative fonts Fonts like Calibri Light, Garamond, or custom fonts cause character errors or blank sections.
Incorrect use of heading styles If headings aren't set with Word's built-in styles, Workable can't identify sections correctly, merging or skipping them.
Image-based PDFs or password-protected files Workable can't parse scanned PDFs or protected files. It treats them as images, losing all text.
Embedded graphics and logos These don't parse and often break layout, causing sections to shift unpredictably.
Step-by-step fix for Workable parsing errors
Remove tables and text boxes
- Open the CV in Word.
- Select the entire document (Ctrl+A).
- Copy and paste it into a new blank Word document using "Paste Special" → "Unformatted Text" or paste normally and then reapply basic formatting manually.
- This strips tables and text boxes, leaving plain text.
Simplify layout to single column
- Avoid multi-column CVs.
- Use line breaks and spacing instead of columns or tables.
- Reformat bullet points with standard Word bullets.
Use standard fonts
- Change font to Arial, Calibri, or Times New Roman throughout.
- Avoid decorative or light fonts.
Apply proper heading styles
- Use Word styles for all section titles (e.g., Heading 1 for Experience).
- This helps Workable segment the CV correctly.
Convert PDFs correctly
- If you must submit PDFs, convert them to editable Word documents first.
- Use OCR tools if the PDF is scanned.
- Avoid password-protected files or PDFs with heavy graphics.
Remove embedded images and logos
- Delete photos, icons, and logos before submission.
- They don't parse and disrupt layout.
How to prevent parsing errors on future submittals
- Standardise your CV templates for Workable compatibility.
- Train candidates or recruiters to avoid tables, columns, and unusual fonts.
- Use Word's built-in heading styles consistently.
- Convert PDFs to Word and check formatting before upload.
- Run a quick copy-paste test into Notepad to catch hidden formatting issues.
- Keep CVs simple and text-based for maximum parser accuracy.
When to escalate to Distill
If you're sending 20 or more CVs to Workable clients each week, manual fixes waste too much time. You need a tool that cleans CVs automatically to Workable's parsing rules.
Distill removes tables, text boxes, images, and sensitive info like names and contact details with one click. It outputs a clean Word doc that Workable parses perfectly, every time.
Distill's automated workflow frees recruiters from formatting headaches and removes compliance risk around candidate data exposure.
FAQ
Q: Why does Workable strip my candidate's phone number? It's usually inside a table or text box. Workable can't read those. Move contact details outside tables or remove tables entirely.
Q: My CV looks fine in Word but is a mess in Workable. What's wrong? Workable reads the underlying structure, not visual layout. Multi-column or table-based CVs look fine but parse badly.
Q: Can I submit PDFs to Workable? Yes, but only if they're text-based and not scanned images. Always convert to Word if in doubt.
Q: Will removing images affect my candidate's chances? Clients rarely want photos or logos on CVs. Removing them prevents parsing errors without losing value.
Q: Does Distill integrate directly with Workable? Distill doesn't integrate natively but works alongside your workflow. You upload the cleaned CV into Workable yourself.
If you're sending 20+ CVs a week to Workable clients, Distill formats them to the spec above automatically. Try Distill free and fix messy Workable parsing errors in 30 seconds.