Strapi Plugin CSV Manager

A powerful Strapi v5 plugin for importing and exporting CSV data with full support for components, relations, media, nested fields, and mapping presets.

✨ Features

Import

• 📁 Upload CSV files with configurable delimiter and encoding
• 🔄 Auto-mapping of CSV columns to Strapi fields
• 📍 Support for nested paths (seo.metaTitle, intro.title, items.0.name)
• 🧩 Components support (single and repeatable)
• 🔗 Relations support (oneToOne, oneToMany, manyToMany)
• 🖼️ Media upload from URLs
• 🔀 Upsert by any unique field (id, slug, email, etc.)
• 👁️ Preview before import
• 💾 Save mapping as preset

Export

• 📊 Select specific fields to export
• 🔗 Configurable relation format (ID, slug, or full JSON)
• 🖼️ Configurable media format (URL, ID, or full JSON)
• 📦 Components exported as JSON
• 🌐 Locale support for i18n content

Presets

• 💾 Save and reuse mapping configurations
• ⚡ Quick import with predefined settings

📦 Installation

npm install @some-dev/strapi-plugin-csv-manager
# or
yarn add @some-dev/strapi-plugin-csv-manager

⚙️ Configuration

Add the plugin to your config/plugins.ts (or config/plugins.js):

export default () => ({
  'csv-manager': {
    enabled: true,
  },
});

Then rebuild your Strapi admin panel:

npm run build
npm run develop

🚀 Usage

After installation, you'll find CSV Manager in the left sidebar of your Strapi admin panel.

Importing CSV

1. Go to CSV Manager → Import tab
2. Select the target Content Type
3. (Optional) Select a saved Preset
4. Upload your CSV file
5. Configure CSV options (delimiter, encoding)
6. Map CSV columns to Strapi fields
7. Select Unique Field for upsert logic
8. Click Preview to verify data
9. Click Import

Exporting CSV

1. Go to CSV Manager → Export tab
2. Select the Content Type
3. Choose fields to export
4. Configure relation/media format
5. Set limit (optional)
6. Click Export

Managing Presets

1. Go to CSV Manager → Presets tab
2. Create, edit, or delete mapping presets
3. Use presets during import for quick configuration

📋 Supported Data Types

Type	Import Format	Export Format
String	Plain text	Plain text
Number	123 or 123.45	Number
Boolean	true/false, 1/0, yes/no	true/false
Date	YYYY-MM-DD, DD.MM.YYYY, DD/MM/YYYY	YYYY-MM-DD
DateTime	ISO 8601 format	ISO 8601
JSON	Valid JSON string	JSON string
Array	value1|value2|value3 or JSON array	Pipe-separated or JSON
Relation	ID, slug, or JSON	ID, slug, or JSON
Media	URL to download	URL or ID
Component	JSON object	JSON object
Repeatable Component	JSON array or pipe-separated JSON objects	JSON array

📝 CSV Format Examples

Basic Import

title;slug;price;is_featured
Product 1;product-1;99.99;true
Product 2;product-2;149.99;false

With Relations

title;slug;category;tags
Product 1;product-1;electronics;tag1|tag2|tag3
Product 2;product-2;clothing;tag4|tag5

With Nested Fields (Components)

title;slug;seo.title;seo.description
Product 1;product-1;SEO Title 1;Meta description 1
Product 2;product-2;SEO Title 2;Meta description 2

With Media URLs

title;slug;image;gallery
Product 1;product-1;https://example.com/img1.jpg;https://example.com/g1.jpg|https://example.com/g2.jpg

With Repeatable Components

title;advantages
Product 1;[{"title":"Fast","description":"Very fast"},{"title":"Reliable","description":"Always works"}]

🔧 Advanced Configuration

Relation Lookup

By default, relations are looked up by id. You can configure lookup by other fields:

• id - Match by Strapi ID
• documentId - Match by document ID
• slug - Match by slug field
• name - Match by name field
• title - Match by title field
• email - Match by email field

Auto-Create Relations

Enable "Auto-create" option to automatically create related entries if they don't exist.

Upsert Logic

Choose a unique field for upsert:

• If a record with matching value exists → Update
• If no match found → Create

🌐 Internationalization

The plugin supports Strapi's i18n plugin:

• Select locale during import/export
• Content is imported/exported for the specified locale

📄 License

MIT License

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🐛 Issues

If you find a bug or have a feature request, please open an issue on GitHub.

📧 Support

For questions and support, please open an issue on the GitHub repository.