function theme_image

7.x theme_image($variables)
5.x theme_image($path, $alt = '', $title = '', $attributes = NULL, $getsize = TRUE)
6.x theme_image($path, $alt = '', $title = '', $attributes = NULL, $getsize = TRUE)

Returns HTML for an image.


$variables: An associative array containing:

  • path: Either the path of the image file (relative to base_path()) or a full URL.
  • width: The width of the image (if known).
  • height: The height of the image (if known).
  • alt: The alternative text for text-based browsers. HTML 4 and XHTML 1.0 always require an alt attribute. The HTML 5 draft allows the alt attribute to be omitted in some cases. Therefore, this variable defaults to an empty string, but can be set to NULL for the attribute to be omitted. Usually, neither omission nor an empty string satisfies accessibility requirements, so it is strongly encouraged for code calling theme('image') to pass a meaningful value for this variable.

  • title: The title text is displayed when the image is hovered in some popular browsers.
  • attributes: Associative array of attributes to be placed in the img tag.

Related topics

17 theme calls to theme_image()
ImageFieldDisplayTestCase::testImageFieldDefaultImage in drupal/modules/image/image.test
Test use of a default image with an image field.
ImageFieldDisplayTestCase::testImageFieldSettings in drupal/modules/image/image.test
Tests for image field settings.
ImageFieldDisplayTestCase::_testImageFieldFormatters in drupal/modules/image/image.test
Test image formatters on node display.
seven_tablesort_indicator in drupal/themes/seven/template.php
Override of theme_tablesort_indicator().
simpletest_result_status_image in drupal/modules/simpletest/
Get the appropriate image for the status.

... See full list

95 string references to the theme hook from theme_image()

Note: this list is generated by looking for the string for this theme hook, so it may include some references that are not actually using this theme hook.

aggregator_element_data in drupal/modules/aggregator/
Performs an action when data is encountered.
aggregator_element_end in drupal/modules/aggregator/
Performs an action when a closing tag is encountered.
aggregator_element_start in drupal/modules/aggregator/
Performs an action when an opening tag is encountered.
aggregator_refresh in drupal/modules/aggregator/aggregator.module
Checks a news feed for new items.
aggregator_save_feed in drupal/modules/aggregator/aggregator.module
Add/edit/delete an aggregator feed.

... See full list


drupal/includes/, line 1876
The theme system, which controls the output of Drupal.


function theme_image($variables) {
  $attributes = $variables['attributes'];
  $attributes['src'] = file_create_url($variables['path']);

  foreach (array('width', 'height', 'alt', 'title') as $key) {

    if (isset($variables[$key])) {
      $attributes[$key] = $variables[$key];

  return '<img' . drupal_attributes($attributes) . ' />';