Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Known Overrides

Security covered Under active development 296 sites

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.

Drupal 10–11

Ask your assistant about Known Overrides

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
3
Tracked since
Jan 2025
Latest release
1 month ago
Releases (12 mo)
2 ▲ from 1
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
1.1.1 Stable 10–11 Oct 1, 2026
1.1.0 Stable 10–11 Mar 27, 2026
1.0.0 Stable 10–11 Jan 15, 2025