Direkt zum Inhalt

Devbits

Kleine Code-Schnipsel aus unserem Alltag mit Drupal, PHP und DevOps: Problem, Lösung, Code.

23.10.2026 | Michael Ebert

Translate tab missing on custom config form

You have created a custom Drupal configuration form but no Translate tab appears when you access it.

my_module.my_form_configuration_tab:
  route_name: my_module.my_form_configuration
  title: Configuration
  base_route: my_module.my_form_configuration

Issue:

You have created a custom Drupal configuration form but no Translate tab appears when you access it.

The config_translation module automatically derives the Translate tab from the configuration mapper. However, Drupal only renders the local task (tab) navigation when there are at least two tabs on the same level. Since the Translate tab is the only local task available, Drupal does not display the tab navigation, causing the Translate tab to remain hidden.

Prerequisites:

You have the config_translations module enabled.

Solution:

Drupal Core solves the issue for settings forms by providing a default tab. We apply the same approach in our module by adding a default local task, which allows Drupal to render the tab navigation and display the Translate tab.

19.03.2026 | Michael Ebert

Preview changed config before import/export with drush

You changed config and want to see the changes before it is exported to your config sync directory or you want to see what will be changed if you import changed config.

First, you could check if there are different states of your config between database and local file system.

drush config:status

There is an option `--diff` for the drush command that will print the changes first.

drush config:import --diff

This also works for config export.

drush config:export --diff

Issue:

You changed config and want to see the changes before it is exported to your config sync directory or you want to see what will be changed if you import changed config.

Solution:

There is an option for the drush commands that will print the changes first.

13.11.2025 | Dominik Wille

Install config from config/install dir in update hook.

You might maintain a Drupal contrib module and want to add some config at a later stage.

/**
 * Save the bulk delete action to config.
 */
function redirect_update_8104() {
  if (!Action::load('redirect_delete_action')) {
    $entity_type_manager = \Drupal::entityTypeManager();
    $module_handler = \Drupal::moduleHandler();

    // Save the bulk delete action to config.
    $config_install_path = $module_handler->getModule('redirect')->getPath() . '/' . InstallStorage::CONFIG_INSTALL_DIRECTORY;
    $storage = new FileStorage($config_install_path);
    $entity_type_manager
      ->getStorage('action')
      ->create($storage->read('system.action.redirect_delete_action'))
      ->trustData()
      ->save();
  }
}

Issue:

You might maintain a Drupal contrib module and want to add some config at a later stage.

Solution:

The provided snippet implements a hook to create config.

Further information

Similar results can be achieved using the Configuration Replace module.