Title: WP_Font_Face::build_font_face_css
Published: November 8, 2023
Last modified: May 20, 2026

---

# WP_Font_Face::build_font_face_css( array $font_face ): string

## In this article

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

[ Back to top](https://developer.wordpress.org/reference/classes/wp_font_face/build_font_face_css/?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.

Builds the font-family’s CSS.

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

 `$font_face`arrayrequired

Font face to process.

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

 string This font-family’s CSS.

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

    ```php
    private function build_font_face_css( array $font_face ) {
    	$css = '';

    	/*
    	 * Wrap font-family in quotes if it contains spaces
    	 * and is not already wrapped in quotes.
    	 */
    	if (
    		str_contains( $font_face['font-family'], ' ' ) &&
    		! str_contains( $font_face['font-family'], '"' ) &&
    		! str_contains( $font_face['font-family'], "'" )
    	) {
    		$font_face['font-family'] = '"' . $font_face['font-family'] . '"';
    	}

    	foreach ( $font_face as $key => $value ) {
    		// Compile the "src" parameter.
    		if ( 'src' === $key ) {
    			$value = $this->compile_src( $value );
    		}

    		// If font-variation-settings is an array, convert it to a string.
    		if ( 'font-variation-settings' === $key && is_array( $value ) ) {
    			$value = $this->compile_variations( $value );
    		}

    		if ( ! empty( $value ) ) {
    			$css .= "$key:$value;";
    		}
    	}

    	return $css;
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/fonts/class-wp-font-face.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/fonts/class-wp-font-face.php#L307)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/fonts/class-wp-font-face.php#L307-L339)

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

| Uses | Description | 
| [WP_Font_Face::compile_src()](https://developer.wordpress.org/reference/classes/wp_font_face/compile_src/)`wp-includes/fonts/class-wp-font-face.php` |

Compiles the `src` into valid CSS.

  | 
| [WP_Font_Face::compile_variations()](https://developer.wordpress.org/reference/classes/wp_font_face/compile_variations/)`wp-includes/fonts/class-wp-font-face.php` |

Compiles the font variation settings.

  |

| Used by | Description | 
| [WP_Font_Face::get_css()](https://developer.wordpress.org/reference/classes/wp_font_face/get_css/)`wp-includes/fonts/class-wp-font-face.php` |

Gets the `@font-face` CSS styles for locally-hosted font files.

  |

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

| Version | Description | 
| [6.4.0](https://developer.wordpress.org/reference/since/6.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_font_face%2Fbuild_font_face_css%2F)
before being able to contribute a note or feedback.