directus-extension-import-excel
v1.1.0
Published
Import Excel files (.xlsx) without headers and manually map them to Directus collections.
Maintainers
Readme
Directus Extension: Import Excel
📥 A Directus custom bundle (module + endpoint) to import .xlsx Excel files without headers and manually map them to a collection's fields.
🚀 Features
- Upload
.xlsxfiles via a custom UI - Manual mapping of file columns to Directus collection fields
- Support for multiple collections
- Optional upsert: update items using a unique key (works only with fields marked as
uniquein Directus) - Field mapping redesigned: vertical layout inspired by NocoDB's import system
- Clear and detailed feedback:
- Loading indicator during import to show progress
- Interface and API fully translated (English, French & Turkish)
- Codebase fully rewritten in English for easier contributions
📸 Screenshots

📦 Installation
✅ Recommended (via Marketplace)
Install directly from the Directus Marketplace
Or search for "fazcode" or "import excel" (the name may evolve to reflect broader format support like JSON or CSV):
http://YourDirectusUrl:8055/admin/settings/marketplace?search=import+excel
🛠 Manual Installation
- Clone the repository into your Directus
extensionsfolder:
git clone https://github.com/FazCodeFR/directus-extension-import-excel.git ./extensions/televersement- Restart your Directus instance to load the new extension.
- Navigate to the Directus admin panel and find the "Téléversement" module in the side menu.
🧪 Usage
- Go to the "Import Excel" module in the Directus admin panel.
- Upload your
.xlsxfile. - Map the columns from your Excel file to the fields in your Directus collection.
- Optionally select a unique field to enable upsert (update if existing).
- Click "Import" to start the process.
- Get detailed feedback on the result of the import.
🤝 Contributing
Contributions are welcome!
If you find a bug or have a feature request, please open an issue or submit a pull request on the GitHub repository.
🧾 License
This project is licensed under the MIT License.
✅ Compatibility
Tested with Directus v11.8.0
