Skip to main content

Webpack Aliases are removed

In Strapi v5, webpack aliases are removed ensuring better compatibility and reduced dependency conflicts.

This page is part of the breaking changes database and provides information about the breaking change and additional instructions to migrate from Strapi v4 to Strapi 5.

Breaking change description​

In Strapi v4

  • We maintained a specific list of dependencies that were aliased in webpack configuration. This ensured that plugins consistently used our versions of certain libraries like the design-system.

In Strapi 5

  • In Strapi v5, we have simplified the aliasing process. Now, we only alias essential dependencies like react, react-dom, react-router-dom, and styled-components.

Migration​

This section regroups useful notes and procedures about the introduced breaking change.

Notes​

  • If you encounter issues with third-party plugins, we recommend opening an issue on the respective plugin's repository. Encourage the plugin maintainers to add their dependencies to their package.json file to resolve compatibility issues.

  • If you encounter issues with local plugins, you can fix them by amending the resolve option in your chosen bundler.

Manual procedure​

To migrate to Strapi 5:

  • Identify any configuration files (e.g., webpack configuration) that referenced the now-removed Webpack aliases in Strapi v4.
  • Ensure that any references to Webpack aliases in the code are replaced with appropriate imports or paths.
  • If third-party plugins are used in the project, verify that they do not rely on Webpack aliases that are no longer present in Strapi v5.
  • If necessary, communicate with the plugin authors to update their dependencies or configurations accordingly.