image.html.twig naming sugestions

Question

I need to customize the image.html.twig template. I have a new content type with an image field (field_tile_image). How can I overwrite the default image template only for one block?

I tried different naming but it's still using image.html.twig. There aren't other name suggestions.

Answer 1

The image.html.twig file does not have any names suggestions by default. Then you have to add it yourself. You can do it using hook_theme_suggestions_alter.

Also, here's an example of this hook usage:

/**
 * Implements hook_theme_suggestions_alter().
 */
function MY_THEME_theme_suggestions_alter(array &$suggestions, array $variables, $hook) {
  if ($hook == 'taxonomy_term') {
    $term = $variables["elements"]["#taxonomy_term"];
    $vid = $term->get('vid')->target_id;
    $view_mode = $variables["elements"]["#view_mode"];
    
    $suggestions[] = $hook . '__' . $view_mode;
    $suggestions[] = $hook . '__' . $vid . '__' . $view_mode;
  }
}

You can read more about it here:
https://www.drupal.org/docs/theming-drupal/twig-in-drupal/working-with-twig-templates
and here:
https://www.drupal.org/docs/theming-drupal/twig-in-drupal/twig-template-naming-conventions