Note: While our most popular guides have been translated into Spanish, some guides are only available in English.
Using Search Blocks

The Search Block adds a search field to your site. You can set the Search Block to show results from across your site or limit results to one content collection.

How search results populate

Like any search engine, Search Block results are based on the quality of the content on your site. To improve results in the Search Block, we recommend adding descriptive and accurate titles, descriptions, excerpts, tags, categories, file names, and keyword-rich content across your site.

For a full list of site content indexed for search, visit Adding search to your site.

Step 1 - Add the Search Block

  1. Open a page or post editor.
  2. Click an Insert Point or the +.
  3. Select Search from the menu.
  4. For more detailed steps, visit Adding blocks.

Step 2 - Select content to search

In the Search window, you can choose to allow results from across your site or limit results to a specific collection.

Allow search results from across your site

To allow results from across your site, leave Search Specific Page unchecked.


Limit search results

To limit results to one specific collection, check Search Specific Page


Select the content that the Search Block will search. You can select one Blog Page, Gallery Page, Events Page, or Products Page. In the example below, the Search Block will only search in the Blog page.


Tip: If you select Search Specific Page, you may want to note that the Search Block will return results for a specific collection. You can do this by adding a Text Block above the Search Block that says, for example, “Search our blog.”

Step 3 - Select click behavior

In the Display tab, check Quick Preview to add a drop-down that auto-populates results as the visitor types. We recommend checking this to allow quicker access to search results.

Step 4 - Select an icon style (optional)

In the Display tab, select Light or Dark to customize how the Search icon and box outline appear on your site. Dark is recommended for sites with light backgrounds. Light is recommended for sites with dark backgrounds.

Step 5 - Save

Click Apply to save your changes.

Use the Search Block 

To use the Search Block, place your cursor in the Search field and begin typing.

If Quick Preview is checked, results populate in a drop-down. The search looks similar to this:

Pressing Enter after searching opens a page with search results. Recommended pages appear with their thumbnails, content snippets, and/or excerpts. If a page doesn’t have a thumbnail image, the first image on the page appears.

FAQ and troubleshooting

Can I add a site-wide Search Block to the top of my site?

It isn't possible to add a Search Block above your page content, but you can add a Search Block to individual pages. The Header Content area is a good place to add it if your template includes it.

You can also add a "Search" link to your built-in search page to your Main Navigation or anywhere links are supported. First, create a URL by add /search to the end of your full domain so it looks like this: "".

Then add the URL to an external link in your navigation or somewhere else like a text link, button block, or button in a special banner.

I can’t see the text I’m typing in the Search field.

By default, the Search Block is set to the Dark theme. If the page background is dark, the search text will blend in. The same can happen if the page background is white and the Search Block is set to the Light theme.

To fix this, switch the theme to Light or Dark in the block’s Display tab.

My search query isn’t generating results.

Try the following steps to generate search results:

If you're still not seeing results after following these troubleshooting steps, contact us, and we'll refresh your site's search on our end.

Was this article helpful?
33 out of 88 found this helpful