is_search() │ WP 1.5.0

Works when the search results page is displayed. Conditional tag.

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Uses: WP_Query::is_search()

No Hooks.

Returns

true|false. Whether the query is for a search.

Usage

<?php
if( is_search() ){
	// ...
}
?>

Examples

-1

#1 How to embed Google search into a search page

An example of how you can embed a Google search in a WordPress search results page

if ( is_search() ) {
	// here you can insert the search code from Google
}

Notes

  • Global. WP_Query. $wp_query WordPress Query object.

Changelog

Since 1.5.0 Introduced.

is_search() code WP 6.8.1

wp-includes/query.php 
function is_search() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_search();
}

Conditional tags (page type and request)

Conditional tags (all)

Queries

Main Functions