Switch Environment

About

The Switch Environment Plugin allows users to easily toggle between production and development database connections in Payload CMS. It can also copy data from the production database to the development environment, ensuring that features requiring both code and data changes can be deployed smoothly. This plugin is essential for developers working with frequent updates on a production database, minimizing the risk of data loss during the development process. To use this plugin, it must be positioned last in the plugins array in the configuration file, with a cloud storage plugin directly preceding it. This ensures that the correct hooks are applied to manage uploads effectively. Key configuration options include setting the database adapter for both production and development, enabling the plugin based on the environment, and specifying options for quick switching or copying data. Limitations include its incompatibility with local file storage uploads in production environments and a lack of support for database migrations. Compatible with Payload 3.0.2 and above, this plugin helps maintain synchronized databases during development, enhancing workflow efficiency.

Package info

Package name

@elliott-w/payload-plugin-switch-env

Latest version

2.0.3

Unpacked size

236 kB

License

MIT

Weekly downloads

60

Last publish

Mar 6, 2026