Title: WP_Theme_JSON::merge_spacing_sizes
Published: February 24, 2026
Last modified: August 20, 2026

---

# WP_Theme_JSON::merge_spacing_sizes( array $base, array $incoming ): array

## In this article

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

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.

Merges two sets of spacing size presets.

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

 `$base`arrayrequired

The base set of spacing sizes.

`$incoming`arrayrequired

The set of spacing sizes to merge with the base. Duplicate slugs will override the
base values.

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

 array The merged set of spacing sizes.

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

    ```php
    private static function merge_spacing_sizes( $base, $incoming ) {
    	// Preserve the order if there are no base (spacingScale) values.
    	if ( empty( $base ) ) {
    		return $incoming;
    	}
    	$merged = array();
    	foreach ( $base as $item ) {
    		$merged[ $item['slug'] ] = $item;
    	}
    	foreach ( $incoming as $item ) {
    		$merged[ $item['slug'] ] = $item;
    	}
    	ksort( $merged, SORT_NUMERIC );
    	return array_values( $merged );
    }
    ```

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

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

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