Package Exports
- import-export-plugin
- import-export-plugin/rsc
- import-export-plugin/types
Readme
Import/Export Plugin for Payload CMS
A plugin for Payload CMS that adds seamless import and export functionality for collection data. This plugin allows admins to easily upload or download data in multiple formats like CSV, JSON, and XLSX through the Payload Admin UI.
✨ Features
- Import data into collections from
.csv
,.json
, and.xlsx
files. - Export collection data to
.csv
,.json
, or.xlsx
formats. - Field mapping support during import to match collection fields.
- Built-in support for Payload's Admin UI.
📦 Installation
Install the plugin using your package manager:
# Using pnpm
pnpm add @your-namespace/import-export-plugin
# Using npm
npm install @your-namespace/import-export-plugin
# Using yarn
yarn add @your-namespace/import-export-plugin
⚙️ Configuration
Add the plugin to your Payload config (payload.config.ts
or payload.config.js
):
import { buildConfig } from 'payload';
import importExportPlugin from '@your-namespace/import-export-plugin';
export default buildConfig({
collections: [
// Your Payload collections here
],
plugins: [
importExportPlugin({
collections: {
posts: true, //collection slug name and enable/disable import/export functionality
},
}),
],
});
📁 File Format Support
Format | Import | Export |
---|---|---|
.json |
✅ | ✅ |
.xlsx |
✅ | ✅ |
🧩 Compatibility
- Payload CMS v3.29.0 or later
- Node.js v18.20.2 or v20.9.0+
- Supports modern bundlers with ESM support
📄 License
This plugin is open source and licensed under the MIT License. See LICENSE for details.
🤝 Contributing
Found a bug or want to improve something? Contributions are welcome!
📚 Resources
🧑🤝🧑 Authors
This project is maintained and developed by: