Title: delete_site_meta
Published: February 22, 2019
Last modified: May 20, 2026

---

# delete_site_meta( int $site_id, string $meta_key, mixed $meta_value = '' ): bool

## In this article

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

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

Removes metadata matching criteria from a site.

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

You can match based on the key, or key and value. Removing based on key and value,
will keep from removing duplicate metadata with the same key. It also allows removing
all metadata matching key, if needed.

For historical reasons both the meta key and the meta value are expected to be “
slashed” (slashes escaped) on input.

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

 `$site_id`intrequired

Site ID.

`$meta_key`stringrequired

Metadata name.

`$meta_value`mixedoptional

Metadata value. If provided, rows will only be removed that match the value.
 Must
be serializable if non-scalar.

Default:`''`

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

 bool True on success, false on failure.

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

    ```php
    function delete_site_meta( $site_id, $meta_key, $meta_value = '' ) {
    	return delete_metadata( 'blog', $site_id, $meta_key, $meta_value );
    }
    ```

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

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

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

Deletes metadata for the specified object.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/functions/delete_site_meta/?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%2Fdelete_site_meta%2F)
before being able to contribute a note or feedback.