| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employees (hr)
• Discuss (mail) |
| Lines of code | 377 |
| Technical Name |
cerevantix_import_employee |
| License | OPL-1 |
| Website | https://cerevantix.com |
| Versions | 17.0 18.0 19.0 |
Bulk Employee Photo Import for modern HR teams
Import employee profile photos from CSV or Excel via hosted URLs — with dry-run preview, row-level error reporting, and a downloadable failed-row export — built natively on Odoo HR.
Odoo’s native CSV import silently strips image fields. Loading or refreshing employee profile photos in bulk forces HR administrators to update each record one at a time, or use a tool that commits data without validation and provides no way to correct failures.
Upload a CSV or Excel file with employee identifiers and photo URLs. Preview matched rows and fetch results before committing. Download a report of failures and re-upload corrections — without re-processing rows that already succeeded.
Everything HR needs for bulk photo import
Every capability below is implemented in the module.
CSV & Excel Upload
Upload a CSV, XLS, or XLSX file directly in the wizard. No format conversion needed before import — both spreadsheet types are accepted.
URL Image Fetch
Fetches employee photos from any accessible URL, including CDN redirect chains. Images are resized and normalised to standard Odoo photo dimensions on ingest.
Flexible Employee Matching
Match employees by display name, identification number, or internal employee ID. Choose the key that matches your source spreadsheet — no reformatting required.
Column-Header Mapping
Column order is irrelevant. The wizard reads by header name and accepts a wide range of common column aliases, so your existing spreadsheet works without rearranging columns.
Dry-Run Preview
Load Preview validates every row — resolves employees, fetches images — without writing a single record. Review the status table before deciding to commit.
Overwrite Control
An explicit toggle before the import begins: skip employees who already have a photo, or overwrite them. Re-run behaviour is always predictable and documented.
Row-Level Status Badges
Every preview row carries a Pending, Skipped, Success, or Error badge with an inline reason message so you know exactly which rows need attention before committing.
Downloadable Error Report
Export only the failed rows as a CSV with an added reason column. Correct those rows and re-upload the fix file without touching already-successful records.
HR Manager Access
The import wizard is available to the HR Manager role by default. HR onboarding staff can self-serve without requesting IT Administrator access.
How it works
Upload File
Open the Import Employee Images wizard from the Employees menu and upload your CSV or Excel file.
Preview Results
Click Load Preview. The wizard resolves employees and fetches images without saving anything yet.
Confirm Import
Review the row-level status table, then click Import Images to write only the valid rows.
Export Errors
Download a CSV of failed rows, fix the issues, and re-upload — successful rows are never reprocessed.
See it in action
Real screens from the module, captured on Odoo 17.
Employees list view — Import Employee Images action accessible from the top navigation.
Employees kanban with Import Employee Images available in the Actions menu.
Wizard draft state: file upload, matching key selector, overwrite toggle, and Download Sample CSV.
Preview state: row-level status table showing Pending, Skipped, and Error entries before any data is written.
Done state: imported and error counts displayed, with Download Error Report available for failed rows.
Frequently asked
Will it overwrite employees who already have a photo?
Only if Overwrite existing photos is enabled. With the toggle off, those rows are marked Skipped and the existing photo is left untouched. The choice is always explicit before the import begins.
What happens when a URL is unreachable?
The row status is set to Error with the failure reason. You can download a CSV of all failed rows, fix the URLs, and re-upload without reprocessing rows that already succeeded.
Does it work on Odoo Online?
No. This module is not compatible with Odoo Online. It is supported on Odoo.sh and on-premise (self-hosted) deployments.
Which fields can I use to match employees?
Display name, identification number (the employee ID card field), or internal Odoo employee ID. Select the Matching Key that matches your spreadsheet before loading the preview.
Get in Touch
Have questions or need customization? Every purchase includes 30 days of free support — we are here to help.
Visit Our Website
www.cerevantix.comExplore our apps, services, and portfolio.
Explore our other apps
A growing suite of Odoo apps.
Empowering growth through technology.
Bulk employee photo import with preview, error reporting, and flexible matching — built natively on Odoo HR.
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employees (hr)
• Discuss (mail) |
| Lines of code | 377 |
| Technical Name |
cerevantix_import_employee |
| License | OPL-1 |
| Website | https://cerevantix.com |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module