Title: WP_Theme::translate_header
Published: April 25, 2014
Last modified: April 28, 2025

---

# WP_Theme::translate_header( string $header, string|array $value ): string|array

## In this article

 * [Parameters](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#wp--skip-link--target)

This function’s access is marked private. This means it is not intended for use 
by plugin or theme developers, only by core. It is listed here for completeness.

Translates a theme header.

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#parameters)󠁿

 `$header`stringrequired

Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags.

`$value`string|arrayrequired

Value to translate. An array for Tags header, string otherwise.

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#return)󠁿

 string|array Translated value. An array for Tags header, string otherwise.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#source)󠁿

    ```php
    private function translate_header( $header, $value ) {
    	switch ( $header ) {
    		case 'Name':
    			// Cached for sorting reasons.
    			if ( isset( $this->name_translated ) ) {
    				return $this->name_translated;
    			}

    			// phpcs:ignore WordPress.WP.I18n.LowLevelTranslationFunction,WordPress.WP.I18n.NonSingularStringLiteralText,WordPress.WP.I18n.NonSingularStringLiteralDomain
    			$this->name_translated = translate( $value, $this->get( 'TextDomain' ) );

    			return $this->name_translated;
    		case 'Tags':
    			if ( empty( $value ) || ! function_exists( 'get_theme_feature_list' ) ) {
    				return $value;
    			}

    			static $tags_list;
    			if ( ! isset( $tags_list ) ) {
    				$tags_list = array(
    					// As of 4.6, deprecated tags which are only used to provide translation for older themes.
    					'black'             => __( 'Black' ),
    					'blue'              => __( 'Blue' ),
    					'brown'             => __( 'Brown' ),
    					'gray'              => __( 'Gray' ),
    					'green'             => __( 'Green' ),
    					'orange'            => __( 'Orange' ),
    					'pink'              => __( 'Pink' ),
    					'purple'            => __( 'Purple' ),
    					'red'               => __( 'Red' ),
    					'silver'            => __( 'Silver' ),
    					'tan'               => __( 'Tan' ),
    					'white'             => __( 'White' ),
    					'yellow'            => __( 'Yellow' ),
    					'dark'              => _x( 'Dark', 'color scheme' ),
    					'light'             => _x( 'Light', 'color scheme' ),
    					'fixed-layout'      => __( 'Fixed Layout' ),
    					'fluid-layout'      => __( 'Fluid Layout' ),
    					'responsive-layout' => __( 'Responsive Layout' ),
    					'blavatar'          => __( 'Blavatar' ),
    					'photoblogging'     => __( 'Photoblogging' ),
    					'seasonal'          => __( 'Seasonal' ),
    				);

    				$feature_list = get_theme_feature_list( false ); // No API.

    				foreach ( $feature_list as $tags ) {
    					$tags_list += $tags;
    				}
    			}

    			foreach ( $value as &$tag ) {
    				if ( isset( $tags_list[ $tag ] ) ) {
    					$tag = $tags_list[ $tag ];
    				} elseif ( isset( self::$tag_map[ $tag ] ) ) {
    					$tag = $tags_list[ self::$tag_map[ $tag ] ];
    				}
    			}

    			return $value;

    		default:
    			// phpcs:ignore WordPress.WP.I18n.LowLevelTranslationFunction,WordPress.WP.I18n.NonSingularStringLiteralText,WordPress.WP.I18n.NonSingularStringLiteralDomain
    			$value = translate( $value, $this->get( 'TextDomain' ) );
    	}
    	return $value;
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-theme.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/class-wp-theme.php#L1050)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/class-wp-theme.php#L1050-L1116)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#related)󠁿

| Uses | Description | 
| [get_theme_feature_list()](https://developer.wordpress.org/reference/functions/get_theme_feature_list/)`wp-admin/includes/theme.php` |

Retrieves list of WordPress theme features (aka theme tags).

  | 
| [translate()](https://developer.wordpress.org/reference/functions/translate/)`wp-includes/l10n.php` |

Retrieves the translation of $text.

  | 
| [WP_Theme::get()](https://developer.wordpress.org/reference/classes/wp_theme/get/)`wp-includes/class-wp-theme.php` |

Gets a raw, unformatted theme header.

  | 
| [__()](https://developer.wordpress.org/reference/functions/__/)`wp-includes/l10n.php` |

Retrieves the translation of $text.

  | 
| [_x()](https://developer.wordpress.org/reference/functions/_x/)`wp-includes/l10n.php` |

Retrieves translated string with gettext context.

  |

[Show 2 more](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#)

| Used by | Description | 
| [WP_Theme::get_post_templates()](https://developer.wordpress.org/reference/classes/wp_theme/get_post_templates/)`wp-includes/class-wp-theme.php` |

Returns the theme’s post templates.

  | 
| [WP_Theme::display()](https://developer.wordpress.org/reference/classes/wp_theme/display/)`wp-includes/class-wp-theme.php` |

Gets a theme header, formatted and translated for display.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_theme/translate_header/?output_format=md#changelog)󠁿

| Version | Description | 
| [3.4.0](https://developer.wordpress.org/reference/since/3.4.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_theme%2Ftranslate_header%2F)
before being able to contribute a note or feedback.