function theme_user_permission_description

Returns HTML for an individual permission description.


$variables: An associative array containing:

  • permission_item: An associative array representing the permission whose description is being themed. Useful keys include:

    • description: The text of the permission description.
    • warning: A security-related warning message about the permission (if there is one).
  • hide: A boolean indicating whether or not the permission description was requested to be hidden rather than shown.

Related topics

1 theme call to theme_user_permission_description()
user_admin_permissions in drupal/modules/user/
Menu callback: administer permissions.


drupal/modules/user/, line 822
Admin page callback file for the user module.


function theme_user_permission_description($variables) {
  if (!$variables['hide']) {
    $description = array();
    $permission_item = $variables['permission_item'];
    if (!empty($permission_item['description'])) {
      $description[] = $permission_item['description'];
    if (!empty($permission_item['warning'])) {
      $description[] = '<em class="permission-warning">' . $permission_item['warning'] . '</em>';
    if (!empty($description)) {
      return implode(' ', $description);