Wix Harmony is Wix's new AI-powered site editor, built on a technical architecture that's different from previous editors. With Harmony, the way apps and extensions work across Wix is evolving. This overview explains app compatibility in Harmony, what's changing, and your options for supporting users across all Wix editors and frameworks.
Note: For information about site development, see About Wix Harmony. For Blocks-specific information, see About Wix Harmony and Blocks.
Apps can be installed in Harmony, though the UI and App Market experience differs from other editors. Due to architectural and technology updates, some app types are only available in certain editors.
| Extension type | Wix Harmony | Wix Editor & Wix Studio |
|---|---|---|
| Dashboard extensions | ✓ | ✓ |
| Backend extensions | ✓ | ✓ |
| CLI site extensions | ✓ | ✓ |
| Self-hosted site extensions | ✓ | ✓ |
| Blocks site widgets and plugins | — | ✓ |
| Legacy custom elements | — | ✓ |
| Legacy iFrame widgets and pages | Partial | ✓ |
Your app's availability in Harmony depends on the types of extensions it includes:
When building a new app, use frameworks supported in Harmony:
We recommend testing your app in Harmony to ensure it works as expected. Create a Harmony development site to test your app's functionality and user experience.
To learn more, see Test Your App on a Free Premium Site.
Currently, there is no automatic migration path to convert Blocks apps directly to the new CLI or site widget tools. To move to the new architecture, you need to build a new extension.
We've created a step-by-step guide on how to rebuild and update your app using the new tools. We're also exploring solutions to streamline this process in the future.
Currently, there is no migration tool from Classic/Studio to Wix Harmony.
You can maintain your existing reviews and install base by adding your new implementation as an additional extension within your existing app, rather than creating a new app. We will be releasing a guide to assist you in migrating your active users from the old extension to the new one.
Wix Harmony is built on a completely new technology that doesn't support Blocks apps, which means they aren't available for installation.
The current path to compatibility with Harmony is to build site widgets using Custom Elements, managed via the Wix CLI or self-hosting. We encourage you to adopt this approach now to regain access to that user base. Additionally, we're working on a comprehensive React-based infrastructure that will provide even more robust options for app development in the near future.
Wix Editor and Wix Studio users still have full access to your apps. If you need to support Wix Harmony sites now, you can start building self-hosted or CLI site widgets.
We aren't breaking any existing capabilities. If at any time we move forward with deprecation, we will make sure there is a clear and concrete plan that addresses all questions and concerns.
If you encounter issues or have questions, feel free to reach out to us or ask in our Discord community.