Turns the configuration export into an overlay of the shipped configuration of all installed configuration. Installing this module and subsequently exporting configuration will leave only those configuration files in your export directory that have been added or modified relative to the shipped configuration of modules and installation profiles.
Concretely, exporting the configuration of a Standard Drupal installation results in almost 200 files that will usually end up in the Git repository for every single one of your Drupal projects even though the majority of those will never be changed in any way. If this bothers you and you consider this a maintenance burden, then this module is for you! Just installing it will reduce that number to just over 10. As you customize your site and add more configuration this number will grow again, but an additional benefit of this module is if you have multiple sites with similar configuration: just place the common configuration in a shared module (or installation profile) and each config export directory is back to only having configuration specific to that particular site.
Installation
Note that the patch from the core issue "Dispatch config transformation event during site install from configuration" is required for Config Overlay to work during installation of a new site. Depending on your setup, this may be required for the site installation to succeed. Otherwise, a configuration import after the installation may be required to add the configuration that was missed during installation.
Related modules
The following modules (in the specified versions) are known to work together with Config Overlay and the integration is tested as part of Config Overlay's test suite. See the README.md for more information.
- Config Ignore (8.x-3.x)
- Config Split (2.0.x)
This module is part of the NO AI initiative. No artificial intelligence was used in creating this module.
Project information
Seeking co-maintainer(s)
Maintainers are looking for help reviewing issues.- Project categories: Developer tools, Import and export
45 sites report using this module
- Created by tstoeckler on , updated
Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
Releases
Fixes support for shipped config translations
Development version: 2.x-dev updated 3 Mar 2026 at 11:50 UTC
Fixes Config Split integration
Development version: 2.x-dev updated 3 Mar 2026 at 11:50 UTC
Drupal 11 compatibility for the legacy 8.x-1.x branch
Development version: 8.x-1.x-dev updated 3 Mar 2026 at 12:28 UTC

