Title: _prime_site_caches
Published: August 16, 2016
Last modified: February 24, 2026

---

# _prime_site_caches( array $ids, bool $update_meta_cache = true )

## In this article

 * [Description](https://developer.wordpress.org/reference/functions/_prime_site_caches/?output_format=md#description)
    - [See also](https://developer.wordpress.org/reference/functions/_prime_site_caches/?output_format=md#see-also)
 * [Parameters](https://developer.wordpress.org/reference/functions/_prime_site_caches/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/functions/_prime_site_caches/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/functions/_prime_site_caches/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/functions/_prime_site_caches/?output_format=md#changelog)

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

Adds any sites from the given IDs to the cache that do not already exist in cache.

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

### 󠀁[See also](https://developer.wordpress.org/reference/functions/_prime_site_caches/?output_format=md#see-also)󠁿

 * [update_site_cache()](https://developer.wordpress.org/reference/functions/update_site_cache/)

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

 `$ids`arrayrequired

ID list.

`$update_meta_cache`booloptional

Whether to update the meta cache.

Default:`true`

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

    ```php
    function _prime_site_caches( $ids, $update_meta_cache = true ) {
    	global $wpdb;

    	$non_cached_ids = _get_non_cached_ids( $ids, 'sites' );
    	if ( ! empty( $non_cached_ids ) ) {
    		$fresh_sites = $wpdb->get_results( sprintf( "SELECT * FROM $wpdb->blogs WHERE blog_id IN (%s)", implode( ',', array_map( 'intval', $non_cached_ids ) ) ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared

    		update_site_cache( $fresh_sites, false );
    	}

    	if ( $update_meta_cache ) {
    		wp_lazyload_site_meta( $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#L353)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/ms-site.php#L353-L366)

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

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

Queue site meta for lazy-loading.

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

Updates sites in cache.

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

Retrieves IDs that are not already present in the cache.

  | 
| [wpdb::get_results()](https://developer.wordpress.org/reference/classes/wpdb/get_results/)`wp-includes/class-wpdb.php` |

Retrieves an entire SQL result set from the database (i.e., many rows).

  |

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

| Used by | Description | 
| [WP_Site_Query::get_sites()](https://developer.wordpress.org/reference/classes/wp_site_query/get_sites/)`wp-includes/class-wp-site-query.php` |

Retrieves a list of sites matching the query vars.

  |

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

| Version | Description | 
| [6.3.0](https://developer.wordpress.org/reference/since/6.3.0/) | Use [wp_lazyload_site_meta()](https://developer.wordpress.org/reference/functions/wp_lazyload_site_meta/) for lazy-loading of site meta. | 
| [6.1.0](https://developer.wordpress.org/reference/since/6.1.0/) | This function is no longer marked as "private". | 
| [5.1.0](https://developer.wordpress.org/reference/since/5.1.0/) | Introduced the `$update_meta_cache` parameter. | 
| [4.6.0](https://developer.wordpress.org/reference/since/4.6.0/) | Introduced. |

## User Contributed Notes

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