@wtree/payload-extended-import-export-plugin

Extended import/export plugin for Payload CMS with additional features and enhancements.

Features

• Import data from CSV/JSON (and other supported formats).
• Field mapping during import.
• Data preview and basic validation.
• Works inside the Payload admin UI.

Installation

npm install @wtree/payload-extended-import-export-plugin

Usage

Add the plugin to your payload.config.ts:

import { payloadExtendedImportExportPlugin } from '@wtree/payload-extended-import-export-plugin'

export default buildConfig({
  plugins: [
    payloadExtendedImportExportPlugin({
      collections: ['posts', 'users'],
      enabled: true,
    }),
  ],
})

Configuration

| Option | Type | Description | |---|---|---| | collections | CollectionSlug[] | Collection slugs where import/export is enabled. | | enabled | boolean | Enable/disable plugin (default: true). |

Localization

English is the default language (fallback) for any UI strings exposed by this plugin.

Development

pnpm install
pnpm lint
pnpm build
pnpm test:int

Publishing

This repository supports automated publishing via GitHub Actions.

Required GitHub secrets:

• NPM_TOKEN: npm access token with publish rights for the @wtree scope.

Publish a new version

Publishing is tag-based: when you push a git tag to origin, the Publish GitHub Actions workflow runs and publishes the package to npm.

From a clean main branch:

git checkout main
git pull

# bump version + create a git commit + create a git tag
npm version patch

# push the commit and tag (this triggers the publish workflow)
git push origin main --follow-tags

Use npm version minor or npm version major when appropriate.

License

MIT - See LICENSE.