Title: update_sitemeta_cache
Published: February 22, 2019
Last modified: February 24, 2026

---

# update_sitemeta_cache( array $site_ids ): array|false

## In this article

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

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

Updates metadata cache for list of site IDs.

## 󠀁[Description](https://developer.wordpress.org/reference/functions/update_sitemeta_cache/?output_format=md#description)󠁿

Performs SQL query to retrieve all metadata for the sites matching `$site_ids` and
stores them in the cache.
Subsequent calls to `get_site_meta()` will not need to
query the database.

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

 `$site_ids`arrayrequired

List of site IDs.

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

 array|false An array of metadata on success, false if there is nothing to update.

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

    ```php
    function update_sitemeta_cache( $site_ids ) {
    	// Ensure this filter is hooked in even if the function is called early.
    	if ( ! has_filter( 'update_blog_metadata_cache', 'wp_check_site_meta_support_prefilter' ) ) {
    		add_filter( 'update_blog_metadata_cache', 'wp_check_site_meta_support_prefilter' );
    	}
    	return update_meta_cache( 'blog', $site_ids );
    }
    ```

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

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

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

Checks if any filter has been registered for a hook.

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

Updates the metadata cache for the specified objects.

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

Adds a callback function to a filter hook.

  |

[Show 1 more](https://developer.wordpress.org/reference/functions/update_sitemeta_cache/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/update_sitemeta_cache/?output_format=md#)

| Used by | Description | 
| [update_site_cache()](https://developer.wordpress.org/reference/functions/update_site_cache/)`wp-includes/ms-site.php` |

Updates sites in cache.

  |

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

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

## User Contributed Notes

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