The second-largest block support file. Handles font size (including fluid/responsive), font family, font style/weight, line height, text alignment, text columns, text decoration, text transform, letter spacing, writing mode, and fit text.

Source: wp-includes/block-supports/typography.php
Since: 5.6.0

Support Key

supports.typography

Registered Attributes

Functions

wp_register_typography_support()

function wp_register_typography_support( WP_Block_Type $block_type )

Since: 5.6.0
Since: 6.3.0 Added support for text-columns.
Access: private

wp_apply_typography_support()

function wp_apply_typography_support( WP_Block_Type $block_type, array $block_attributes ): array

Since: 5.6.0
Since: 6.1.0 Used the style engine to generate CSS and classnames.
Since: 6.3.0 Added support for text-columns.
Access: private

For each typography feature:

1. Checks feature support flag
2. Checks serialization skip
3. Reads preset or custom value
4. For fontSize: preset → var:preset|font-size|{slug}, custom → processed through wp_get_typography_font_size_value() for fluid sizing
5. For fontFamily: preset → var:preset|font-family|{slug}, custom → through wp_typography_get_preset_inline_style_value()
6. For textAlign: adds has-text-align-{value} class in addition to inline style

Delegates to wp_style_engine_get_styles() with convert_vars_to_classnames => true.

Returns: Array with class and/or style.

wp_typography_get_preset_inline_style_value()

function wp_typography_get_preset_inline_style_value( string $style_value, string $css_property ): string

Since: 6.1.0

Backwards-compatibility function for blocks with preset typography values (removed in gutenberg#27555). Converts var:preset|{property}|{slug} to var(--wp--preset--{property}--{slug}).

wp_render_typography_support()

function wp_render_typography_support( string $block_content, array $block ): string

Since: 6.1.0

Processing:

1. Fit Text (since the code checks $block['attrs']['fitText']):

   • If fitText is truthy and not admin: enqueues @wordpress/block-editor/utils/fit-text-frontend script module
   • Adds Interactivity API directives: data-wp-interactive, data-wp-context---core-fit-text, data-wp-init---core-fit-text, data-wp-style--font-size
   • Returns early — fitText supersedes other typography features

2. Fluid Font Size:

   • If style.typography.fontSize is set, processes through wp_get_typography_font_size_value()
   • If fluid size differs from custom size, replaces first font-size:{custom} occurrence in markup with font-size:{fluid}

wp_get_typography_value_and_unit()

function wp_get_typography_value_and_unit( string|int|float $raw_value, array $options = array() ): ?array

Fit Text (since the code checks $block['attrs']['fitText']):

Fluid Font Size:

Fit Text (since the code checks $block['attrs']['fitText']):

wp_get_computed_fluid_typography_value()

function wp_get_computed_fluid_typography_value( array $args = array() ): ?string

Fluid Font Size:

Since: 6.1.0

clamp({min_font_size}, {min_font_size_rem} + ((1vw - {viewport_offset}) * {scale_factor}), {max_font_size})

Parses a size value into value and unit components. Supports px, rem, em. Can coerce between units using a configurable root_size_value (default 16).

wp_get_typography_font_size_value()

function wp_get_typography_font_size_value( array $preset, bool|array $settings = array() ): ?string

Options:

Since: 6.1.0
Since: 6.3.0 Checks for unsupported min/max viewport values.
Since: 6.5.0 Returns early on zero viewport subtraction to avoid division by zero.
Access: private

1. Returns null if no size in preset
2. Returns early if $preset['fluid'] is false or size is empty
3. If $settings is bool, triggers deprecation notice (since 6.6.0)
4. Falls back to global settings via wp_get_global_settings()
5. Returns early if fluid is disabled globally AND no local fluid settings

Computes a clamp() CSS value for fluid typography:

Args:

factor = min(max(1 - 0.075 * log2(preferred_px), 0.25), 0.75)
minimum = preferred_size * factor

Generated CSS Classes

Hooks

Registration

WP_Block_Supports::get_instance()->register(
    'typography',
    array(
        'register_attribute' => 'wp_register_typography_support',
        'apply'              => 'wp_apply_typography_support',
    )
);

Since: 6.1.0
Since: 6.1.1 Adjusted rules for min and max font sizes.
Since: 6.2.0 Added settings.typography.fluid.minFontSize support.
Since: 6.3.0 Using layout.wideSize as max viewport width; logarithmic scale factor for minimum font scale.
Since: 6.4.0 Added configurable min/max viewport width to typography.fluid schema.
Since: 6.6.0 Deprecated bool argument $should_use_fluid_typography.
Since: 6.7.0 Font size presets can enable fluid individually even if disabled globally.