Warning: This function has been deprecated. Use wp_insert_site() instead.

insert_blog( string $domain, string $path, int $site_id )

Store basic site info in the blogs table.

Description Description

This function creates a row in the wp_blogs table and returns the new blog’s ID. It is the first step in creating a new blog.

See also See also

Top ↑

Parameters Parameters


(string) (Required) The domain of the new site.


(string) (Required) The path of the new site.


(int) (Required) Unless you're running a multi-network install, be sure to set this value to 1.

Top ↑

Return Return

(int|false) The ID of the new row

Top ↑

Source Source

File: wp-includes/ms-deprecated.php

function insert_blog($domain, $path, $site_id) {
	_deprecated_function( __FUNCTION__, '5.1.0', 'wp_insert_site()' );

	$data = array(
		'domain'  => $domain,
		'path'    => $path,
		'site_id' => $site_id,

	$site_id = wp_insert_site( $data );
	if ( is_wp_error( $site_id ) ) {
		return false;

	clean_blog_cache( $site_id );

	return $site_id;

Top ↑

Changelog Changelog

Version Description
5.1.0 Use wp_insert_site()
MU (3.0.0) Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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