Classic Search to Jetpack Search 3.0 migration guide

Posted on June 10, 2026 by shaylynnm

This guide helps site owners running Classic Search upgrade to Jetpack Search 3.0. You’ll learn what’s changed, how to migrate, and what to do if something doesn’t look right after you switch.

What is Classic Search?

Classic Search is the original Jetpack Search experience. It replaces the default WordPress database query with Elasticsearch-powered results, but uses your theme’s built-in search page to display them. Filters are configured through the Jetpack Search widget in Appearance → Widgets, and search settings live under Jetpack → Settings → Performance.

If your search results page looks like the rest of your theme and you’ve never enabled the Instant Search overlay, you’re on Classic Search.

What’s changing in Search 3.0

Search 3.0 introduces a completely new way to build and customize your search experience using blocks in the editor. Instead of relying on widgets and your theme’s search template, you assemble your search page from a set of composable Jetpack Search blocks in the Site Editor.

Here’s how the two experiences compare:

Classic Search (v1)Search 3.0 (embedded search)
How results displayYour theme’s search templateA block-based page template you customize in the editor
How you configure filtersJetpack Search widget in Appearance → WidgetsFilter blocks added directly to your search page
Post type exclusionsOne sitewide list in the Jetpack Search settings panelPer-page, using the Post Type Scope block
Sort optionsLimited to the widget’s built-in optionsA Sort By block with configurable options per page
Result formatControlled by your themeThree block-based layouts: Compact, Expanded, and Product (WooCommerce)
Search inputYour theme’s search formA Search Input block you place wherever you want
TechnologyStandard WordPress hooksWordPress Interactivity API, renders inline with your theme

Before you migrate

Before switching, take note of your current Classic Search configuration so you can recreate it in Search 3.0:

  1. Go to Appearance → Widgets and open the Jetpack Search Sidebar widget area. Note which filters you have configured (categories, tags, post types, dates, custom taxonomies) and their order.
  2. Go to Jetpack → Search and note any post types you’ve excluded from results.
  3. If you’ve set a default sort order, note that as well.

You won’t lose any search data during the migration. Your Elasticsearch index, search history, and indexed content remain unchanged. The migration only changes how results are displayed and how filters are configured.

How to switch to Search 3.0

  1. Make sure your Jetpack plugin is updated to version 15.9 or later.
  2. Go to Jetpack → Search in WP Admin.
  3. In the search experience selector, choose Embedded search. This replaces the previous toggle for “Enable instant search experience.”
Annotation on 2026-05-29 at 08-41-03.png
  1. A Jetpack Search page template is automatically created for your site. Your search URL (for example, yourjetpack.blog/?s=hello) now renders this template instead of your theme’s search page.

To customize the template, go to Appearance → Editor → Templates and select Jetpack Search. You can add, remove, and rearrange blocks just like any other page template.

See Jetpack Search blocks for more on getting started with Embedded search.

Recreating your Classic Search settings

Filters

In Classic Search, filters lived in the Jetpack Search widget. In Search 3.0, each filter type has its own block.

To recreate your filters:

  1. Open the Jetpack Search template in Appearance → Editor → Templates.
  2. Add a Filters block (or Collapsible Filters for compact layouts) to create a filter sidebar.
  3. Inside the container, add the filter blocks that match your previous widget configuration:
Classic Search widget filterSearch 3.0 block
CategoriesFilter (Checkbox) set to Category
TagsFilter (Checkbox) set to Tag
Post typesPost Type Scope
Date (year/month)Filter by Date
Custom taxonomiesFilter (Checkbox) set to Custom Taxonomy
AuthorsFilter (Checkbox) set to Author
  1. Configure each filter block’s settings in the editor sidebar to match your previous setup (sort order, maximum items, display style).

For more detailed settings on each filter block, see Jetpack Search blocks: filter types.

Post type exclusions

In Classic Search, excluded post types were a sitewide setting you configured once in the Jetpack Search settings panel. That single list applied to every search on your site.

In Search 3.0, post type scoping is per-page. Instead of one global exclusion list, you add a Post Type Scope block to each search page. This block lets you include or exclude specific post types for that page only, so different search pages can show different content types.

To recreate your exclusions:

  1. Open the Jetpack Search template in Appearance → Editor → Templates.
  2. Click the + inserter inside your filters area and add a Post Type Scope block.
  3. In the block’s settings panel, choose the post types you want to include or exclude.
  4. Repeat for any other search pages on your site that need the same exclusions.

The Post Type Scope block doesn’t display anything to your visitors. It works behind the scenes to control which content types appear in results.

Sort order

In Classic Search, the default sort order was a sitewide setting. In Search 3.0, add a Sort By block to your search page and configure which sort options are available to visitors. The block supports Relevance, Newest, and Oldest by default.

Result format

Classic Search used your theme’s markup to display results. Search 3.0 uses a Results List block with three layout options:

  • Compact displays the title and a short excerpt.
  • Expanded adds an image thumbnail and breadcrumbs.
  • Product is designed for WooCommerce stores and shows the product image, title, price, and star rating.

Choose the format that best matches what your visitors expect to see.

What to expect after the switch

  • Your search URL stays the same. Visitors searching your site won’t notice a URL change.
  • Your Elasticsearch index is unaffected. All your indexed content, search stats, and ranking signals carry over automatically.
  • Your old Jetpack Search widget in Appearance → Widgets will no longer control what appears in search results. You can remove it once you’ve confirmed your new search page is working.
  • If anything looks unexpected after switching, you can reset the search template to its default. Go to Appearance → Editor → Templates, select Jetpack Search, and use the reset option.

Switching back

If you want to return to the previous search experience, go to Jetpack → Search and select a different option from the experience selector. Your Classic Search widget configuration in Appearance → Widgets is still there if you haven’t removed it.

Still need help?

Please contact support. We’re happy to advise.

Comments Off on Classic Search to Jetpack Search 3.0 migration guide

Customize Jetpack Instant Search

Posted on June 5, 2022 by stefmattana

Jetpack Search uses an overlay to display all search results when the Instant search experience option is enabled. This guide demonstrates how to customize this overlay.

You can customize the look and feel of the Search results overlay to ensure it fits in well with your theme. You can also adjust how your search results are sorted, which post types to exclude from search results and several additional display settings.

Jetpack Instant Search is used on our support page, you can give it a try at https://jetpack.com/support/.

Requirements for Jetpack Search

Install and activate Jetpack or the standalone Jetpack Search plugin on your site and sign up for a Jetpack Search plan. This support guide provides more information about how to do that.

Activate and Customize Instant Search

To set up the Jetpack Instant Search options:

  1. From WP Admin, navigate to Jetpack → Search.
  2. Toggle on the option Enable instant search experience.
  3. Then click Customize search results.
  4. On the right sidebar, make sure the Options tab is selected

The Options tab will display all the customization options available, described in the next section.

Overview of the Jetpack Instant Search Options

Styling Jetpack Search

You can adjust the layout and color schemes as follows:

  • Light and Dark modes: Use this to set the display mode for the search results overlay to light or dark mode. In light mode, dark or black text is shown on a white or light background, while in dark mode, the white or light-colored text is displayed on a dark or black background.
  • Result format: Choose the format of the search results:
    • Minimal – Displays the result title along with either:
      • The matching content or product description (if a keyword is found there), or,
      • An excerpt if the match was found in another field (e.g., custom meta field or title).
    • Expanded – Same as Minimal, but includes an image thumbnail (if available) and a navigation path (breadcrumbs).
    • Product – Displays results in a grid format, ideal for WooCommerce stores. Each result includes the product title, image, and price (if available). This format does not display keyword highlights.
  • Highlight for search terms:
    • You can select the highlight color for search terms as they appear in search results (in the titles, excerpts, or descriptions). You can pick from displayed color options or use the color palette to choose a custom color.
    • Search terms are automatically highlighted in Minimal and Expanded result formats. This behavior cannot be disabled, but you can use jetpack_instant_search_options filter to select which fields should be highlighted. See this example for more details.

Jetpack Search settings

These options help you fine-tune the search results as the user looks for information on your site.

Default sort

In the drop-down options, choose your preferred default sort order for the search results:

  • Relevance: This is the recommended and default choice. When selected, Jetpack will show results in the order of most relevant to the search term to least relevant.
  • Newest first: When selected, Jetpack will sort the results by date and show the latest records first.
  • Oldest first: When selected, Jetpack will sort the results by date and show the oldest records first.

Overlay trigger

In the drop-down options, pick your preferred trigger for the search results overlay:

  • Open when user submits the form: This is the default choice. When selected, the overlay shows up when the user submits the search form by either clicking Search or tapping the Enter or Return key on their keyboard, that is when the user has finished entering their search term or query.
  • Open when user starts typing: When selected, the overlay shows up as soon as the user starts typing their search term or query, and the results get updated as the user continues to type.

There’s also the option to Open overlay from filter links which is toggled on by default. When enabled, the search results overlay opens when any search filters are used as Jetpack Search takes over. If you have custom filters on your Search results page, you may want to turn this off, and do not want Jetpack’s Instant Search to conflict with that. You can read more on how to set up filters in this section.

Excluded post types

You can exclude records that belong to one or more post types from the search results. This is useful when you have private or restricted post types with records you don’t want users to find.

Additional Jetpack Search settings

The additional settings include:

  • Show sort selector: This is enabled by default. You can toggle this off to hide the sort selector from the search results overlay if you don’t want users to select how they want the results shown to be ordered.
  • Enable infinite scroll: This is enabled by default. When active, more results are loaded and displayed as the user scrolls down to the end of the visible list of search results. You can toggle this off to disable that behavior.
  • Show post date: This is turned on by default and shows or hides the publishing date for each post or record in the search results.
  • Show Price: This option is enabled by default and controls whether the product price is displayed to visitors. Turning it on will show the price on the product listing or page, while turning it off will hide the price from view.

Customize Jetpack Search results with the Customizer

This is relevant if your site is using an older non-block theme that doesn’t support full site editing and instead still uses the older WordPress Theme Customizer – as opposed to the newer Site Editor to provide customization settings.

With a non-block theme, you can still access the Search options through Jetpack → Search as described in the earlier section. But, if you prefer using the Customizer to configure the appearance of your site, here’s how to navigate to the Jetpack Search section of the Customizer:

  1. From your WP Admin dashboard, go to Appearance → Customize.
  2. Click on the section Jetpack Search.

The Jetpack Search section in the Customizer will display all the options described in the previous section for you to configure the appearance of the Instant Search overlay.

Configure Jetpack Search filters

Thanks to the filters, visitors can quickly discover and browse through content on your site. This feature is available on desktop and mobile searches.

When you enable Jetpack Search, a widget area called Jetpack Search Sidebar will automatically be added to your site. This widget area controls what appears in the right sidebar on the Instant Search results overlay.

The Jetpack Search Sidebar comes preloaded with filters that you can remove and configure as you like. To adjust these filters:

  1. Go to Appearance → Widgets.
  2. Click Jetpack Search Sidebar to expand the widget area if it is collapsed.
  3. Select the Jetpack Search widget block to bring up the different filters.

If you add filters in a different widget area outside of the Jetpack Search Sidebar, any filters you configure will open the search overlay automatically, no matter where the widget lives. This can be disabled by toggling off the Open overlay from filter links setting as described in the previous section.

The available filters are:

  • Post types
  • Author
  • Blog
  • Custom Taxonomies (only a subset is supported)
    • Categories
    • Tags
    • Formats
    • Product categories
    • Product tags
    • Product shipping classes
    • Product Attributes
  • Date
    • Year
    • Month

If you remove all the widgets from the Jetpack Search Sidebar widget area, all the filter options will disappear from the right sidebar of the search results overlay.

The Jetpack Search overlay should be triggered by almost any search box on your site’s pages that is added by your theme.

If you use a block theme with Site Editor support, you can add a search form to any part of your site that your theme allows you to edit with WordPress full site editing capabilities. For example, to add a search box to your navigation menu at the top of your site:

  1. Proceed to Appearance → Editor.
  2. Select Navigation from the menu on the left sidebar.
  3. Click the pencil icon to edit your site’s navigation menu.
  4. Use the plus (+) icon to look for and add the Search block.

If your theme doesn’t support the Site Editor and has a sidebar, you can add a search form to the sidebar:

  1. Go to Appearance → Widgets.
  2. Expand the Sidebar or Blog Sidebar widget area by clicking on it or the arrow icon next to the title.
  3. Add the Jetpack Search widget block into the sidebar area. You can also configure and add filters from here.

If your theme does not have a sidebar or a built-in search box, then you can also add it by creating a child theme and then adding code to your header that calls get_search_form(). Some themes will have a built-in search box that is not compatible with Jetpack Search. If this is the case for you, there are a few things you can try.

Open the overlay with a search button

Sometimes, all you need is a search button on your site to open the overlay. The search button on the top of this page uses this HTML:

<a class="header__search-btn jetpack-search-filter__link" href="#">
	<svg class="gridicon gridicons-search" height="24" width="24" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><g><path d="M21 19l-5.154-5.154C16.574 12.742 17 11.42 17 10c0-3.866-3.134-7-7-7s-7 3.134-7 7 3.134 7 7 7c1.42 0 2.742-.426 3.846-1.154L19 21l2-2zM5 10c0-2.757 2.243-5 5-5s5 2.243 5 5-2.243 5-5 5-5-2.243-5-5z"></path></g></svg>					
</a>

Any link on the page can trigger opening the search overlay and applying whatever filters you desire. The link needs a few special attributes to work:

  • Set the class for the a HTML tag to jetpack-search-filter__link and the href attribute to #
  • To filter by a taxonomy, the link attributes are data-filter-type, data-taxonomy, and data-val. For example, data-filter-type="taxonomy" data-taxonomy="category" data-val="performance"
  • To filter by month, the link attributes are: data-filter-type="month_post_date" data-val="2020-01-01"
  • To filter by year, the link attributes are: data-filter-type="year_post_date" data-val="2020-01-01"
  • To filter by post type, the link attributes are: data-filter-type="post_type" data-val="jetpack_support"

Here is an example of filtering by the product Post type:

<a href="#" class="jetpack-search-filter__link" data-filter-type="post_types" data-val="product" >Search Products</a>

Note: Custom filter links will only work if that taxonomy was configured as a filter in a Jetpack Search widget or the Jetpack Search Sidebar.

Still need help?

Please contact support. We’re happy to advise.

Comments Off on Customize Jetpack Instant Search

Jetpack Search

Posted on April 9, 2020 by shaylynnm

Power up your visitors’ search results with Jetpack Search, a powerful replacement for the standard WordPress search capability.

Jetpack Search replaces the standard WordPress search with a faster, more relevant search experience powered by Elasticsearch. Search 3.0 introduces composable search blocks that integrate directly into your theme, AI-powered answers that summarize your content for visitors, and a redesigned dashboard with search analytics.

Elasticsearch is a trademark of Elasticsearch BV, registered in the U.S. and other countries.

Help your visitors find what they need

Choose the right Jetpack Search plugin

Jetpack Search can be used via one of two plugins:

Read about general Jetpack requirements to make sure it is compatible with your website.

Once you have installed and activated one of the plugins, navigate to Jetpack → Search in WP Admin.

Choose the right Jetpack Search Plan

Jetpack Search is free for sites with up to a limited number of records and search requests per month.

For larger sites with more traffic, upgrade to Jetpack Search subscription or a Jetpack bundle that includes Search.

Read more about the Jetpack Search pricing and billing structure.

After choosing a plan, Jetpack will get to work on indexing the records in your website so that we can serve up results to your visitors.

WooCommerce Search Features

When WooCommerce is active, Jetpack Search unlocks an additional set of product-specific filter blocks — price range, stock status, star rating, product attributes, and a ready-made shop sidebar. These blocks only appear in the block editor on WooCommerce sites and are documented separately:

  • WooCommerce filter blocks — setup and settings for Filter by Price, Filter by Rating, Filter by Stock Status, Filter by Product Attribute, and the Product Filters container

Indexing your website

When you first install Jetpack, it may take a few minutes or hours before your content is fully indexed. After that, new and updated content is usually indexed within seconds.

Jetpack Search automatically indexes:

  • All public posts
  • All public pages
  • WooCommerce products
  • Products from other eCommerce platforms
  • The metadata of the publicly-accessible items in your Media Library, such as alt text

Jetpack Search does not index:

  • Draft posts and pages
  • Private pages and posts
  • Password-protected pages and posts
  • The content of PDF files

Search Experiences

Jetpack Search offers several search experiences: Off (the default WordPress search), Overlay (an instant-search modal), Theme (uses our theme’s search layout), and Embedded Search Blocks (the Jetpack Search 7.0.0 experience, which places search and Reader Chat directly inside your pages).

Choose your experience in Jetpack → Search under Search Experience.

Off

This option disables Jetpack Search, and your site uses the default WordPress search.

Overlay search

Overlay search displays results in a floating modal that appears over your page content. This is the experience previously known as “Instant Search.” Visitors type a query, and results appear in real time within the overlay without navigating away from the current page.

To customize the overlay appearance, result format, filters, and sorting options, see Customize Jetpack Instant Search.

Theme search

Theme search uses your theme’s built-in search template to display results. Jetpack Search still powers the backend, but the search results page inherits your theme’s layout, fonts, and styles as-is. No Jetpack Search template is applied.

Theme search has no additional Jetpack-side customization options. To change how results look, edit your theme’s search template in the Site Editor or theme files.

Embedded search

Embedded search uses composable Gutenberg blocks to build a search results page that integrates directly with your theme. Instead of a floating modal, search results appear on a dedicated page that inherits your theme’s fonts, colors, and spacing.

Embedded search includes a set of blocks for the search input, results list, filters, sorting, and pagination. You can arrange these blocks however you like using the block editor, and choose from pre-built patterns such as the blog search page layout and the compact search layout.

On block-based themes, the auto-generated search template integrates natively with your theme’s layout. No custom CSS is needed in most cases. On classic themes, the template renders within the theme wrapper but may need minor styling adjustments.

Learn more about getting started with Embedded search in Jetpack Search blocks.

Switching from overlay to embedded search

If you’re currently using overlay search (previously called “Instant Search”) and want to try embedded search, here’s what to expect:

  • The floating modal is replaced entirely. There is no coexistence mode where both run at the same time.
  • The search URL (/?s=query) renders the embedded page template instead of triggering the overlay.
  • Any custom CSS written to style the overlay modal will not apply to the embedded experience. Review your custom styles after switching.
  • Customizations made to the legacy Jetpack Search widget (sidebar widget) are not carried over. The block-based template starts fresh.
  • You can switch back to overlay at any time from Jetpack → Search in WP Admin using the experience selector. No data is lost when switching.

AI Answers

Jetpack Search can use AI to summarize your content and answer visitor questions directly within the search results. AI answers appears at the top of the results list when the AI has something useful to add, and stays out of the way for standard keyword searches.

AI answers is available on paid Jetpack Search plans and Jetpack Complete. Learn more about setting up and customizing AI answers in the AI answers in Jetpack Search guide.

Still need help?

Please contact support. We’re happy to advise.

Privacy Information

The Search block is deactivated by default. You can activate or deactivate the feature by toggling the Enable Search setting in the Search section from Jetpack → Settings → Performance in your dashboard.

Data Used
Site Owners / Users

We use the WordPress.com-connected blog ID in order to submit a visitor’s search request to the WordPress.com servers. Additionally, for activity tracking (detailed below): IP address, WordPress.com user ID, WordPress.com username, WordPress.com-connected site ID and URL, Jetpack version, user agent, visiting URL, referring URL, timestamp of event, browser language, country code.

Site Visitors

We use any of the visitor-chosen search filters and query data in order to process the search request on the WordPress.com servers. We also use aggregate data about page views and searches to adjust our search results.

Activity Tracked
Site Owners / Users

We track when, and by which user, the feature is activated and deactivated. We also track when, and which, configuration settings are modified (and by which user), as well as when, and by which user, the Jetpack Search widget is updated.

Site Visitors

None.

Data Synced (Read More)
Site Owners / Users

We sync website content and options to provide search results and improve our search results ranking algorithms.

Site Visitors

None.

Comments Off on Jetpack Search

Customize Jetpack Inline Search

Posted on December 5, 2017 by Paulina Hetman

Let’s say you run a blog covering various topics like technology, travel, and food. With Inline Search, you have the power to tailor how your search function operates and appears to your visitors. Want to make it easy for users to narrow down their search results? You can utilize sidebar filters, which are conveniently accessible in the Customizer. Let’s say a visitor lands on your blog and wants to find articles specifically related to technology. With sidebar filters, they can easily select the ‘Technology’ category to refine their search. But if you’re looking to implement more intricate changes, like customizing search behavior based on user interactions, you can delve into the world of custom code. By adding custom code snippets, you can unlock advanced customization options, ensuring your search functionality perfectly aligns with your site’s unique needs and user expectations.

Note: These filters only apply to Inline search, not Instant Search.

Add sidebar filters using the customizer

Search filters can be enabled through the widget’s settings or in the customizer. First, add the Search (Jetpack) widget to your sidebar, then run a search so that you will be able to customize the results. The filters are only displayed when on a search results page, but the search box (if enabled) in the widget will get displayed on all pages. Also, the filters are only displayed if the current search results would have more than one filter.

Below is an example configuration where we have three types of filters: categories, the month the post was published, and what type of post (e.g. page/post/product).

How to add sidebar filters using code

You can also enable sidebar filters on your search results page by adding the Search widget and then customizing them with code. Here is a simple example:

function jp_search_setup_filters() {
	if ( class_exists( 'Jetpack_Search' ) ) {
		Jetpack_Search::instance()->set_filters( array(
			'Categories' => array(
				'type'     => 'taxonomy',
				'taxonomy' => 'category',
				'count'    => 10,
			),
			'Tags' => array(
				'type'     => 'taxonomy',
				'taxonomy' => 'post_tag',
				'count'    => 10,
			),
			'Month' => array(
				'type'     => 'date_histogram',
				'field'    => 'post_date',
				'interval' => 'month',
				'count'    => 10,
			),
		) );
	} else {
		error_log( "Jetpack search does not exist" );
	}
}
add_action( 'init', 'jp_search_setup_filters' );

The code snippets below provide examples of some of the other filters included for Inline Search. You can add these code snippets to a functionality plugin, or to your theme’s functions.php file.

You can also check Jetpack’s source code to discover more filters.

Please note that these snippets are provided as a convenience and our support team does not offer assistance on customizing them further.

In order for these filters to appear, you must add the Search (Jetpack) widget to your sidebar or other widget area.

Add WooCommerce product filters to the sidebar

For the filtered search of WooCommerce products we can do something similar to the other coding example:

function woo_search_setup_filters() {
	if ( class_exists( 'Jetpack_Search' ) ) {
		Jetpack_Search::instance()->set_filters( array(
			'Categories' => array(
				'type'     => 'taxonomy',
				'taxonomy' => 'product_cat',
				'count'    => 10,
			),
		) );
	} else {
		error_log( "Jetpack search does not exist" );
	}
}
add_action( 'init', 'woo_search_setup_filters' );

Adding filters to the page without using a widget

If you want to add a Filters section to your theme, you can use the Jetpack_Search_Template_Tags::render_available_filters() template tag in the search.php theme template like this:

<?php if ( class_exists('Jetpack_Search_Template_Tags' ) ): ?>
	<h2>Filter posts</h2>
	<?php Jetpack_Search_Template_Tags::render_available_filters(); ?>
<?php endif; ?>

Note that for any filters to appear, you need to have programmatically defined custom filters as per the examples above.

Customizing the WordPress Search Query

Jetpack Search will only work with the main search WP_Query. If you want to modify the default WordPress search page, for example, including additional post types in search results, we don’t recommend creating a custom WP_Query as this will not work with Jetpack Search. Instead, we recommend using the pre_get_posts filter. By leveraging this filter, you can modify the main search WP_Query to include additional post types seamlessly. This ensures that Jetpack Search continues to operate smoothly while still allowing you to customize the WordPress search page to meet your specific needs.

Debug Search Query

Jetpack Search has built-in support for two plugins for examining the search query and search query results: Query Monitor and Debug Bar.

Once the plugin is enabled, on any search page you can open the tool and go to the Jetpack Search tab to see the queries that were run and their results. This valuable insight allows you to identify any potential issues, fine-tune search parameters if needed, and ensure a seamless search experience for your users.

How to exclude posts by tags/post_id/etc using a Search Algorithm Filter

The posts that are returned as a part of the search can be easily filtered by wrapping the main search query in a bool query that adds some filters.

Here is a simple case that excludes any post with the tag slug exclude_me:

function filter_jetpack_search_query( $es_query_args, $query ) {
	$es_query_args['query'] = array( 'bool' => array(
		'must' => array( $es_query_args['query'] ),
		'must_not' => array(
			array( 'term' => array( 'tag.slug' => 'exclude_me' ) )
		),
	) );
	return $es_query_args;
}
add_filter( 'jetpack_search_es_query_args', 'filter_jetpack_search_query', 10, 2 );

Filtering can be made significantly more complex. Here we exclude: post_ids 3, 4, and 5; the category exclude_me; and the tag exclude_me

function filter_jetpack_search_query( $es_query_args, $query ) {
	$es_query_args['query'] = array( 'bool' => array(
		'must' => array( $es_query_args['query'] ),
		'must_not' => array(
			array( 'terms' => array( 'post_id' => array( 3, 4, 5 ) ) ),
			array( 'term' => array( 'category.slug' => 'exclude_me' ) ),
			array( 'term' => array( 'tag.slug' => 'exclude_me' ) ),
		),
	) );
	return $es_query_args;
}
add_filter( 'jetpack_search_es_query_args', 'filter_jetpack_search_query', 10, 2 );

Search within a single category with an Algorithm Filter

Sometimes you may only want your search results to be within a single category. Similar to excluding posts, we wrap the main query in a bool query. In this case, we will only search for posts that have the category include_me1 or include_me2.

function filter_jetpack_search_query( $es_query_args, $query ) {
	$es_query_args['query'] = array( 'bool' => array(
		'must' => array( $es_query_args['query'] ),
		'filter' => array(
			array( 'terms' => array( 'category.slug' => array( 'include_me1', 'include_me2' ) ) )
		),
	) );
	return $es_query_args;
}
add_filter( 'jetpack_search_es_query_args', 'filter_jetpack_search_query', 10, 2 );

Searching custom taxonomy with an algorithm

The search tool doesn’t automatically look through custom categories (taxonomies). However, you can tell it to include them in the search. Here’s how you can do that using an example: product_tag:

function set_jetpack_search_fields( $query_args ) {
	$query_args['query_fields'] = array(
		'title.en^2',
		'content.en',
		'excerpt.en',
		'tag.name',
		'category.name',
		'taxonomy.product_tag.name',
	);

	return $query_args;
}
add_filter( 'jetpack_search_es_wp_query_args', 'set_jetpack_search_fields', 10, 1 );

Note that this is boosting the title to have twice the weight of the other fields. This method can also be used to adjust your boosting.

Currently, the search index does not have any view counts available, but you can boost based on the number of comments which often works well:

function boost_jetpack_search_query( $es_query_args, $query ) {
	$es_query_args['query'] = array(
		'function_score' => array(
			'query'     => $es_query_args['query'],
			'functions' => array(
				array(
					'field_value_factor' => array(
						'field'    => 'comment_count',
						'factor'   => 5,
						'modifier' => 'log2p',
						'missing'  => 1,
					),
				),
			),
		),
	);
	return $es_query_args;
}
add_filter( 'jetpack_search_es_query_args', 'boost_jetpack_search_query', 10, 2 );

If you have Jetpack Likes enabled, then you could also boost with a combination of both likes and comments:

function boost_jetpack_search_query( $es_query_args, $query ) {
	$es_query_args['query'] = array(
		'function_score' => array(
			'query'     => $es_query_args['query'],
			'functions' => array(
				array(
					'field_value_factor' => array(
						'field'    => 'comment_count',
						'factor'   => 5,
						'modifier' => 'log2p',
						'missing'  => 1,
					),
				),
				array(
					'field_value_factor' => array(
						'field'    => 'like_count',
						'factor'   => 5,
						'modifier' => 'log2p',
						'missing'  => 1,
					),
				),
			),
		),
	);
	return $es_query_args;
}
add_filter( 'jetpack_search_es_query_args', 'boost_jetpack_search_query', 10, 2 );

Boosting posts with images using a Search Algorithm

For some sites, the best posts are the ones with the most images or galleries in them. We maintain two fields with a count of the number of images and galleries that can be used for boosting.

function boost_jetpack_search_query( $es_query_args, $query ) {
	$es_query_args['query'] = array(
		'function_score' => array(
			'query' => $es_query_args['query'],
			'functions' => array(
				array(
					'field_value_factor' => array(
						'field'    => 'has.image',
						'factor'   => 5,
						'modifier' => 'log2p',
						'missing'  => 1,
					),
				),
				array(
					'field_value_factor' => array(
						'field'    => 'has.gallery',
						'factor'   => 5,
						'modifier' => 'log2p',
						'missing'  => 1,
					),
				),
			),
		),
	);
	return $es_query_args;
}
add_filter( 'jetpack_search_es_query_args', 'boost_jetpack_search_query', 10, 2 );

How to boost pages over posts with a Search Algorithm

Matching any filter can be used as a way to boost search results. Fields such as post_type and post_format are often good choices for boosting certain types of content over others:

function boost_jetpack_search_query( $es_query_args, $query ) {
	$es_query_args['query'] = array(
		'function_score' => array(
			'query'     => $es_query_args['query'],
			'functions' => array(
				array(
					'filter' => array(
						'term' => array( 'post_type' => 'page' )
					),
					'weight' => 10,
				),
			),
		),
	);
	return $es_query_args;
}
add_filter( 'jetpack_search_es_query_args', 'boost_jetpack_search_query', 10, 2 );

Elasticsearch is a trademark of Elasticsearch BV, registered in the U.S. and in other countries.

Still need help?

Please contact support. We’re happy to advise.

Comments Off on Customize Jetpack Inline Search

Jetpack Inline Search

Posted on September 27, 2017 by stefmattana

Jetpack Inline Search is deprecated and we recommend all users switch to Jetpack Instant Search, our newer search solution. Check here for more details on Instant Search.

This information is preserved for our customers who are still using Inline Search, but we do plan on removing that option completely in the future.

Jetpack Inline Search indexes all WordPress posts, pages, and custom post types as long as the post status is one of ‘publish’, ‘trash’, ‘pending’, ‘draft’, ‘future’, or ‘private’.

Get Inline Search on your site

Once you’ve connected your site, follow these steps to add Inline Search:

  1. Go to WP Admin → Jetpack → Settings → Performance
  2. Enable Search. Jetpack will then override the website’s default WordPress backend search system.
  3. Keep the Enable instant search experience (recommended) toggle turned OFF.
  1. Click Add Jetpack Search Widget to add Inline Search to your site using your theme’s customizer.
  2. Choose the Widget area which you wish to display the Search Box. (Number and types of Widget areas will depend on your theme.)
  3. Click Add a widget.
  4. Select the Search (Jetpack) widget.

From there, you can also choose whether to display the search box or not, and whether to show the sorting selection dropdown. You can customize what post types to search and the default sort order. Finally, you can add custom filters that let your site visitors select category, tag, post format, date, post type, and so on.

Filters will only display in the widget on the search results page, after you perform a search.

Taxonomies and post meta in Jetpack Inline Search

When you add an extra filter to the widget – for example, to refine a search by taxonomy – the links for taxonomy terms will only appear in the search widget if there is at least one taxonomy term for the given results. Results with zero matching taxonomy terms will not show the filter controls. This is to prevent user confusion by having redundant controls taking up space on the screen.

Post meta is not included in the index. Custom taxonomies are currently in the index, but the indexing structure has changed, so we do not recommend them for custom queries. For better post meta and custom taxonomy support, consider using Instant Search on your site.

For advanced customizations with relevant code snippets, see how to customize Inline Search.

Still need help?

Please contact support. We’re happy to advise.

Comments Off on Jetpack Inline Search

Jetpack Stats

Posted on November 6, 2013 by shaylynnm

Track your site visits and other valuable insights, so you can drive more traffic to your website.

View your stats

Non-commercial sites can use Jetpack Stats for free. Commercial sites require a paid plan, which comes with priority support and access to advanced features.

Read more about free vs. paid stats.

You can view your stats in different ways using Jetpack:

On your WP Admin dashboard, check out at-a-glance stats on the Site Stats widget.

Get more in-depth stats by following these steps:

  1. Go to your site’s WP Admin.
  2. Navigate to My Jetpack.
  3. Check out your 7-day highlights for a quick summary.
  4. Click on See Detailed stats to see more information.

Access Jetpack Stats dashboards

See the information you want broken down into specific categories:

For information on configuring Jetpack Stats, see this support guide. For issues with Jetpack Stats and general FAQs, see this troubleshooting and FAQs guide.

Note: Jetpack Stats on Jetpack sites does not track or show you Totals, Followers, and Shares on your stats page. It also does not track file downloads for any files hosted on your server, such as PDF links.

Hide the view count for posts in WordPress.com Reader

If you have Jetpack Stats enabled, the Reader feed shows the view count for each post with at least 10 views.

If you do not want view counts to show on your posts in the Reader, you can disable this feature in the Jetpack Stats settings by following these steps:

  1. Go to WP Admin and then Jetpack → Settings in the sidebar. 
  2. Click Traffic.
  3. Scroll down to the Jetpack Stats section and expand it.
  4. Toggle the WordPress.com Reader “Show post views for this site” setting to the off position.

Honor DNT

Do Not Track (DNT) is a feature in web browsers and websites that asks advertisers and other web software providers to not track individuals’ browsing habits. As a site owner, you can force the Jetpack Stats feature to honor any visitors with DNT enabled and not track their activity (i.e., post and page views). For information about how to do this, see our DNT Guide.

Turn off Jetpack Stats

If you would ever like to disable the Jetpack Stats function, please follow these steps:

  1. Go to the Modules page link located in the footer of the Jetpack Settings page (WP Admin → Jetpack → Settings).
  2. Find the Jetpack Stats feature.
  3. Click Deactivate.

Enable Jetpack Stats

To enable Jetpack Stats:

  1. Go to your site’s WP Admin. 
  2. Then, go to Jetpack → Settings. 
  3. Select the Traffic tab.
  4. Click Activate Jetpack Stats, if it is not already active.

You can also use the Stats feature on a multisite network. Read more about how to enable Stats on a WordPress multisite network.

Privacy Information

Jetpack Stats are activated by default. You can deactivate it by following the instructions on how to deactivate Jetpack Stats.

Data Used
Site Owners / Users

This feature requires usage of the following information and data: WordPress.com user ID, WordPress.com-connected blog ID, domain name, site timezone, blog charset, blog admin color preference, Jetpack version, site title and description, and permalink settings.Additionally, for activity tracking (detailed below): IP address, WordPress.com user ID (if logged in), WordPress.com username (if logged in), user agent, visiting URL, referring URL, timestamp of event, browser language, country code.

 Site Visitors

IP address, WordPress.com user ID (if logged in), WordPress.com username (if logged in), user agent, visiting URL, referring URL, timestamp of event, browser language, country code. Please also see Data Visibility and Retention information for this feature.
Activity Tracked
Site Owners / Users

We track when, and by which user, the feature is activated and deactivated. We also track when, and which, configuration settings are modified (and by which user). If the user viewing the stats explicitly requests to view them without JavaScript turned on, we will set a cookie to remember this preference.

We also track stats page views in your dashboard.

Additionally, if the site’s settings are configured to record events for logged-in users of the site, the following events will also be recorded: post and page views, video plays (if videos are hosted by WordPress.com), outbound link clicks, referring URLs and search terms, and country.

You can now honor a visitor’s DNT preference, as well.

 Site Visitors

Post and page views, video plays (if videos are hosted by WordPress.com), outbound link clicks, referring URLs and search engine terms, and country. When this feature is enabled, Jetpack also tracks performance on each page load that includes the JavaScript file we use for Stats. This is exclusively for aggregate performance tracking across Jetpack sites in order to make sure that our plugin and code is not causing performance issues. This includes the tracking of page load times and resource loading duration (image files, JavaScript files, CSS files, etc.).

A site owner can choose to honor your DNT preference.
Data Synced (Read More)
Site Owners / Users

We sync options that identify whether or not the feature is activated and how its available settings are configured.

 Site Visitors

None.

Data Visibility and Retention

Any piece of data explicitly identifying a specific user (IP address, WordPress.com ID, WordPress.com username, etc.) is not visible to the site owner when using this feature. For example, a site owner can see that a specific post has 285 views, but he/she cannot see which specific users/accounts viewed that post.

Stats logs — containing visitor IP addresses and WordPress.com usernames (if available) — are retained by Automattic for 28 days and are used only for the purpose of powering this feature.

Comments Off on Jetpack Stats

  • Enter your email address to receive news and updates from Jetpack

  • Join 99.3K other subscribers

  • Browse by Topic