Search

Jetpack Search is a powerful replacement for the search capability built into WordPress. It is a paid upgrade to the Jetpack plugin that provides higher quality results and an improved search experience. Upgrade today to get started.

Our advanced search solution is backed by Elasticsearch, Jetpack Stats, and our globally distributed data centers. We process your data with multiple technologies to build a modern search experience that improves website engagement, so visitors can search, refine their results, and find the best content and products.

This feature is available with a Jetpack Search subscription and is priced based on how much content is on your site.

Top Features:

  • Instant(*) search and filtering without reloading the page.
  • Real-time indexing supports your search as you type.
  • Theme compatibility for both desktop and mobile.
  • Prioritized results based on your site traffic give better results than the default WordPress search query and also better than other search plugins.
  • Spelling correction and highlighting matching terms.

(*) “Instant” search is also sometimes known as live search, “AJAX” search, realtime search, or dynamic search. As the user is typing the search results autoupdate to minimize how long it takes to find results. On mobile devices this is particularly important.


Getting Started


Troubleshooting and Advanced Customization


Privacy Information

This feature is deactivated by default, and activating/unlocking it requires an upgrade to a Jetpack Search subscription. If you ever need to deactivate the feature, you can do so 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

We anonymously track when and what visitors search for and click on. This data is used to improve our search algorithms and track how well search is working. This tracking includes: IP address, URL, user agent, timestamp of event, browser language, country code, search query, filters.

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 Search

Progressive Web Apps

This feature was removed in Jetpack 7.9. If you’re looking for Progressive Web Application (PWA) functionalities, we recommend installing another plugin that offers the functionality you need.

Note: we’re unable to provide recommendations for third-party plugins, but as with all plugins, we recommend that you choose one that has good ratings, is compatible with the most recent version of WordPress, and deals with support requests promptly.

 

Comments Off on Progressive Web Apps

Site Accelerator (Formerly Photon)

Note: “Photon” is now part of Site Accelerator.

Jetpack’s Site Accelerator helps your pages load faster by allowing Jetpack to optimize your images and serve your images and static files (like CSS and JavaScript) from our global network of servers.

How to Activate the Site Accelerator

  1. In your site’s dashboard, go to Jetpack → Settings→ Performance.
  2. In the Performance & speed section, toggle on “

How Site Acceleration Works

Images

Our image CDN (formerly Photon) is an image acceleration and editing service. That means that we host your images from our servers, alleviating the load on your server and providing faster image loading for your readers.

Static Files

We host static assets like JavaScript and CSS shipped with WordPress Core, Jetpack, and WooCommerce from our servers as content delivery network (CDN), alleviating the load on your server.

  • It filters URLs of assets that are loaded with every WordPress page.
  • It currently only acts on assets shipped with WordPress Core, Jetpack, and WooCommerce. Theme and other plugin assets are not supported at this time.

Limitations

  • No cache invalidations – currently the images are cached “forever” and static assets will be tied to the public version of WordPress, Jetpack, or WooCommerce that you’re using. For images, if you want to “refresh” an image you will need to change its file name. Adding random query arguments, commonly known as cachebusters, will not work.
  • If there is an image you’d like us to purge, please contact us with a direct link to the file as it appears on your site. These will begin with i0.wp.com, i1.wp.com, i2.wp.com or i3.wp.com.
  • We only fetch, resize, and serve gif, png, and jpg images from servers that listen on port 80 for HTTP and port 443 for HTTPS. This is about 99.99% of the web servers in the world. If you are having issues, please try using the jetpack_photon_reject_https filter.
  • We will not “upscale” an image in most circumstances. If your original image is 1000px wide and you ask for us to make it 5000px, we will serve you the original 1000px image. Upscaled images are usually of poor quality and we want to avoid that.
  • If your server takes longer than 10 seconds to upload the image to our CDN, the upload will time out and your image will appear to be broken. Try to upload a differently-named image with a smaller file size if this happens.

Themes and plugins can also use the Photon API to transform images using GET query arguments. Developers will find Photon API examples and documentation on developer.wordpress.com.

This is only allowed to be used by sites hosted on WordPress.com, or on Jetpack-connected WordPress sites. If you move to another platform, or disconnect Jetpack from your site, please also switch to another magic image service. Abuse of Jetpack or violation of the WordPress.com Terms of Service could result in suspension of your site from WordPress.com-connected services.

Questions & Answers

How does Site Accelerator determine which dimensions to serve for an image?

It looks at the img element’s width and height attributes and then serves an image resized to those dimensions or to the width of the containing element (whichever is smaller). By default, Jetpack will constrain images to the larger of the size indicated when adding the image to a post or to your theme’s “content width” setting. If one isn’t set, Jetpack will default to 1000px. This is to help ensure that sites are not trying to serve images larger than what the theme intended to be able to display.

Is there any way to keep the “width” and “height” attributes in the CDN-generated HTML?

We remove the width and height arguments to prevent your images from skewing when the resized image doesn’t have the same dimensions as the original. This is particularly important when you switch from one theme to another, and the new theme is narrower than the previous theme. One of the benefits of it is that it will automatically resize your images so they don’t exceed the width supported by your theme.

Troubleshooting tips

I enabled Site Accelerator and the images have disappeared
  • As a first step, check that your Jetpack connection is working properly.
  • As a next step, it is possible that there may be another plugin on your site conflicting with Site Accelerator. Please try to disable all of your plugins except Jetpack, then try checking your images again. If they are displaying properly, we’ll know that another plugin is interfering here. You can find out which plugin is the culprit by enabling each plugin one by one and checking images after each one.
  • If it still is not working after disabling the plugins, it may be the theme. To test this, you can switch to one of the default themes such as Twenty Seventeen.  If the issue is resolved then you know it’s a problem with the theme, and you’ll need to contact the theme author for further assistance.
  • If Site Accelerator is still not working after that, please reach out to us for more support.

Privacy Information

This feature is deactivated by default. If you ever need to deactivate this feature, you can toggle them off under the Performance & speed section from Jetpack → Settings→ Performance in your dashboard.

More information about the data usage on your site

This feature is deactivated by default. If you ever need to deactivate this feature, you can toggle them off under the Performance & speed section from Jetpack — Settings — Performance in your dashboard.

Data Used
Site Owners / Users

While not actively used in the delivery of this functionality, EXIF data may exist (and be accessible to site visitors) in any of the images that you upload to your site.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

None.

Activity Tracked
Site Owners / Users

We track when, and by which user, the feature is activated and deactivated.

Site Visitors

None.

Data Synced (Read More)
Site Owners / Users

We sync a single option that identifies whether or not the feature is activated.

Site Visitors

None.

Comments Off on Site Accelerator (Formerly Photon)

Lazy Images

Lazy Images makes pages load much faster by only loading visible images, waiting to load images that are offscreen as you scroll down.

In an effort to improve and optimize your site’s loading time, Lazy Images provides a significant benefit in page speed and bandwidth and is especially great for users in low-bandwidth or expensive-bandwidth environments, particularly for mobile users.

Please note that this feature is compatible with WordPress core’s Lazy-Loading images feature.

Activating Lazy Images

  1. Navigate to Jetpack → Settings → Performance.
  2. Scroll to the Performance and Speed section.
  3. Click the toggle to activate Lazy loading for images.

What does it do?

Lazy images filters the post content and modifies image tags so that the src attribute loads a transparent placeholder image.

So, for example, <img src="https://jetpack.com/image.jpg" /> would become something like <img src="https://jetpack.com/placeholder.jpg" data-lazy-src="https://jetpack.com/image.jpg" /> .

When JavaScript then loads, it will look for all images in the current view and replace the src attribute with what is in data-lazy-src. This also occurs as the user scrolls down the page and images come into view.

Why does this matter?

Lazy images can drastically improve site performance. With mobile usage of the Internet now surpassing that of the desktop, the majority of our users are likely accessing our content with mobile devices. Site performance optimization is incredibly significant.

By default, when a web page loads, it attempts to also load all of the images that it sees in the source. For a visitor using a desktop browser, the time and bandwidth necessary to load that page may not be an issue.

For mobile visitors, where the view is much narrower and bandwidth is a more significant concern, this full loading can be problematic. That’s using bandwidth to load images that they may not even want to see.

With lazy images, those images will only load when they actually appear on-screen, reducing bandwidth usage by as much as half of what is used without lazy images enabled.

Customizing Lazy Images

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

These filters allow you to tweak the lazy image functionality.

Lazy images is set to be enabled for your entire site by default. You can use the filter is lazyload_is_enabled to customize when lazy loading should be enabled. For example, if you don’t want lazy images to run on a certain page, you could hook in and disable lazy images for that page.

By default, Jetpack will load a 1×1 transparent gif, but certain implementations may call for something else. The filter lazyload_images_placeholder_image will allow you to specify your own placeholder image.

The jetpack_lazy_images_new_attributes filter will allow you to modify the attributes for a lazy loaded image as the content is filtered. This is to allow for changes based on more customized and specific implementations.

You can instruct Lazy Images to skip any image using the skip-lazy css class or any given class of your choice by using the jetpack_lazy_images_blacklisted_classes filter.

Have questions? Please feel free to contact us  for more personalized assistance.

Privacy Information

This feature is deactivated by default. If you ever need to deactivate this feature, you can toggle the Lazy load images setting in the Speed up your site section from Jetpack — Settings — Performance in your dashboard.

More information about the data usage on your site
Data Used
Site Owners / Users 

 

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 

 

None.

Activity Tracked
Site Owners / Users 

 

We track when, and by which user, the feature is activated and deactivated.

Site Visitors 

 

None.

Data Synced (Read More)
Site Owners / Users 

 

We sync a single option that identifies whether or not the feature is activated.

Site Visitors 

 

None.

Comments Off on Lazy Images

Search

Jetpack’s Search module is a powerful replacement for the search capability built into WordPress. It provides higher quality results and an improved search experience; runs in the WordPress.com cloud; and has a public api for developers to run their own Elasticsearch queries.

This feature is available to users with a Jetpack Search subscription.

Jetpack Elasticsearch-powered Search on a Photography blog

You can use this module out of the box without worrying about configuration options or you have the option to fine-tune the sorting and filtering settings for your site search.

An example sidebar showing filtering on a test site.

An example sidebar showing filtering on a test site.

Detailed Search Feature List

There are a lot of features in Jetpack search that make a great search experience:

  • Supports millions of queries across millions of documents.
  • Real-time indexing of changes to your content.
  • Filter searches by tags, categories, custom taxonomies, authors(WordPress.com connected users only), dates, and post types.
  • Supports all languages with custom language analysis for 29 languages.
  • Sort by relevance or date.
  • Boosts recent content by default.
  • Phrase search.
  • Customizable search algorithm and an Elasticsearch Query API.
  • Transparently intercepts searches via WP_Query, for “search” style queries that are also the “main” query.

Enabling Search

To use Jetpack Search, you must be a Jetpack Search subscriber. Once you’ve connected your site, go to Settings → Performance in your WordPress dashboard, and enable Search.

Performance options user interface for the Jetpack Search product

What is Elasticsearch?

Elasticsearch is an open source project for building distributed, scalable search engines. We power a number of our features using Elasticsearch instead of the MySQL Database that is used for most of WordPress.

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

See our search feature page for an overview of the service.

Testing Instant search and filtering prototype

As part of Jetpack 7.9, we’re testing the ability to search and filter instantly. We’d love for you to try this out and help us test!

How long will it take to index my content?

New and updated content is usually indexed within seconds. When you first install Jetpack, it may take a few minutes or hours before your content is fully indexed, but after that, the index is always up-to-date. If you are an existing Jetpack user, your content will be searchable as soon as you enable the module.

What content is indexed?

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

Does Search have content limits or tiers?

No limits, no tiers, no hidden costs. All your content in real time.

How do I enable this in my theme?

Search works with WordPress’ own search widget, the search box in your theme (if there is one), or by using the Jetpack Search widget which can display a search box, sorting controls and custom filters that let your site visitors select category, date, post type and more.

You can use the customizer or write custom code to add search features to your theme, including our powerful filtering.

Does Search have any filter or action hooks?

Of course! You can find those on our developer page. 

Can I use this for custom Elasticsearch queries?

Yes! You can send any valid Elasticsearch query (ES 2.4+) to Jetpack_Search::instance()->search( $query ). Security restrictions apply. See the API developer docs for more information.

Can I search post meta and custom taxonomies?

Post meta is not currently included in the index, we plan to start whitelisting post meta from popular plugins in the near future. Custom taxonomies are currently in the index, but the indexing structure will likely change so we do not recommend them for custom queries.

I added extra filters to the search widget, but they’re not showing on the page – how do I get them to appear?

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

jpsearch-2015-filters

Secondly, 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.

The search widget shown on the right is configured with Date, Post Type and Tag fields, but only the Dates and Post types are showing because no tags matched the results.

Where can I learn more about the API?

If you have questions or concerns, we would love to hear from you! Feel free to contact us.

Privacy Information

This feature is deactivated by default, and activating/unlocking it requires an upgrade to a Jetpack Search subscription. If you ever need to deactivate the feature, you can do so 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.

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 options that identify whether or not the feature is activated and how its available settings are configured. This includes the Jetpack Search widget.

Site Visitors

None.

Comments Off on Search
  • Enter your email address to follow this blog and receive news and updates from Jetpack!

    Join 175,458 other followers

  • Browse by topic