Hey everyone! ![]()
I’m excited to share a custom Directus bundle (interface + module + API endpoint) I’ve been working on:
Import Excel Extension
It allows you to import .xlsx files without headers and map each column manually to fields of any Directus collection.
Key Features
- Upload
.xlsxfiles via a custom UI - Manual mapping of file columns to Directus collection fields (even without headers!)
- Multi-collection support
- Optional upsert mode (based on a unique field)
- Translated interface & API responses:

- Clear feedback and loading indicators throughout the process
- Codebase fully rewritten in English for easy contributions
UI Preview
Installation
Marketplace (Recommended)
You can install it directly via the Directus Marketplace:
Search: "import excel" or "fazcode"
Marketplace link:
YourDirectusUrl:8055/admin/settings/marketplace/extension/678ba940-192e-4524-949f-8881ad1436bb
Manual Install
git clone https://github.com/FazCodeFR/directus-extension-import-excel.git ./extensions/directus-extension-import-excel
cd directus-extension-import-excel
npm run install
Then restart your Directus instance.
How it Works
- Go to the Import Excel module
- Upload a
.xlsxfile (no header required) - Manually map columns to the fields of your target collection
- Optionally enable upsert mode using a unique field
- Import and get feedback on what happened (inserted, updated, skipped…)
Feedback & Contributions
I’m looking for any feedback, suggestions, or PRs — feel free to test it and let me know what you think!
GitHub: GitHub - FazCodeFR/directus-extension-import-excel: Directus extension module import excel (xlsx)
Tested with Directus v11.9.3
Licensed under MIT
Thanks for reading! ![]()
