/Drupal 8

function hook_block_view_BASE_BLOCK_ID_alter

hook_block_view_BASE_BLOCK_ID_alter(array &$build, \Drupal\Core\Block\BlockPluginInterface $block)

Provide a block plugin specific block_view alteration.

In this hook name, BASE_BLOCK_ID refers to the block implementation's plugin id, regardless of whether the plugin supports derivatives. For example, for the \Drupal\system\Plugin\Block\SystemPoweredByBlock block, this would be 'system_powered_by_block' as per that class's annotation. And for the \Drupal\system\Plugin\Block\SystemMenuBlock block, it would be 'system_menu_block' as per that class's annotation, regardless of which menu the derived block is for.


array $build: A renderable array of data, as returned from the build() implementation of the plugin that defined the block:

  • #title: The default localized title of the block.

\Drupal\Core\Block\BlockPluginInterface $block: The block plugin instance.

See also


Entity CRUD, editing, and view hooks

Related topics

Block API
Information about the classes and interfaces that make up the Block API.
Define functions that alter the behavior of Drupal core.


core/modules/block/block.api.php, line 124
Hooks provided by the Block module.


function hook_block_view_BASE_BLOCK_ID_alter(array &$build, \Drupal\Core\Block\BlockPluginInterface $block) {
  // Change the title of the specific block.
  $build['#title'] = t('New title of the block');

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.