Drupal is a registered trademark of Dries Buytaert
Release: Leaflet 10.4.11 Minor update available for module leaflet (10.4.11). Release: Session Inspector 1.0.8 Minor update available for module session_inspector (1.0.8). Release: Migrate QA 2.0.4 Minor update available for module migrate_qa (2.0.4). Release: CKEditor Description List 3.0.0 Major update available for module ckeditor_descriptionlist (3.0.0). Release: FlowDrop 2.4.0 Minor update available for module flowdrop (2.4.0). Release: JWT Token Refresh 1.0.4 Minor update available for module jwt_token_refresh (1.0.4). Release: ConReg 1.0.0-beta1 First beta version released for module conreg (1.0.0-beta1). Release: AI Image Studio 1.0.0-beta8 New beta version released for module ai_image_studio (1.0.0-beta8). Usage Milestone: Role Theme Switcher Module role_theme_switcher crossed 1,000 active installs. Module Revived: Decoupled Router 2.0.7 Module decoupled_router updated after 11 months of inactivity (2.0.7).

Known Overrides

247 sites Security covered
View on drupal.org

This module helps you track configuration overrides made in your settings files. It then provides a report highlighting the differences between your overridden settings and the default configuration, preventing confusion and potential issues.

Known Overrides is a simple module that can help you set up config overrides in your settings.php or settings.local.php and flag them in the Known Overrides Report, where only the differences between the Config and Override Config are shown.

Why do we need this? Modules like Mail Safety are amazing at stopping email leaking from your local ddev version of the site. But when reviewing the Mail Safety settings form, you won't see your overrides there, and then start to panic if your emails are leaking via SMTP.

Post-Installation

Edit your settings.local.php file

After the `<?php` line add the following array check, and setter.

if (!isset($settings['knownOverrides'])) {
  $settings['knownOverrides'] = [];
}

Add your config override

// Config override
$config['mail_safety.settings']['enabled'] = TRUE;
// Add the config name `mail_safety.settings` to settings knownOverrides array
$settings['knownOverrides'][] = 'mail_safety.settings';

The items stored in $settings['knownOverrides'] will then be compared to the editable config and any differences reported on.

Similar projects

  • Configuration Override Warn module will report within a config form if there are any overrides detected. Highly recommended. However, it does not offer a separate report outside of the overridden module's configuration.

Community Documentation

See the readme.md file for more information.

Activity

Tracked releases
1
Tracked since
Mar 2026
Latest release
4 months ago
Releases (12 mo)
1 ▲ from 0
Maintenance
Active

Releases

Version Type Release date
1.1.0 Stable Mar 27, 2026