Extension Import Excel without Headers + Manual Field Mapping

Hey everyone! :waving_hand:

I’m excited to share a custom Directus bundle (interface + module + API endpoint) I’ve been working on:
:backhand_index_pointing_right: Import Excel Extension

It allows you to import .xlsx files without headers and map each column manually to fields of any Directus collection.


:rocket: Key Features

  • Upload .xlsx files 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: :united_kingdom: :france: :türkiye:
  • Clear feedback and loading indicators throughout the process
  • Codebase fully rewritten in English for easy contributions

:camera_with_flash: UI Preview


:package: Installation

:white_check_mark: 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

:hammer_and_wrench: 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.


:test_tube: How it Works

  1. Go to the Import Excel module
  2. Upload a .xlsx file (no header required)
  3. Manually map columns to the fields of your target collection
  4. Optionally enable upsert mode using a unique field
  5. Import and get feedback on what happened (inserted, updated, skipped…)

:handshake: 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)


:white_check_mark: Tested with Directus v11.9.3
:page_facing_up: Licensed under MIT

Thanks for reading! :folded_hands:

4 Likes