wp_cache_add( int|string $key, mixed $data, string $group = '', int $expire )

Adds data to the cache, if the cache key doesn’t already exist.

Description Description

See also See also

Top ↑

Parameters Parameters


(int|string) (Required) The cache key to use for retrieval later.


(mixed) (Required) The data to add to the cache.


(string) (Optional) The group to add the cache to. Enables the same key to be used across groups.

Default value: ''


(int) (Optional) When the cache data should expire, in seconds. Default 0 (no expiration).

Top ↑

Return Return

(bool) False if cache key and group already exist, true on success.

Top ↑

Source Source

File: wp-includes/cache.php

function wp_cache_add( $key, $data, $group = '', $expire = 0 ) {
	global $wp_object_cache;

	return $wp_object_cache->add( $key, $data, $group, (int) $expire );

Top ↑

Changelog Changelog

Version Description
2.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.