Skip to main content

Site Search

Give visitors a Search Box to find content across your site. Aglyn ships a built-in search page — there's nothing to configure, enable, or index.

Plan availability

Included on every plan, free tiers too.

The elements drawer, open on its first category, Sections & Blocks. The Search Box is further down, under Forms

How it works​

The Search Box element is a simple form: a visitor types a query and submits it to your site's built-in /search page, which renders the matching results. There's no JavaScript and no external search service — the page reads your published content directly when the visitor searches.

What it searches​

A search matches the query as a case-insensitive substring across three kinds of content:

  • Pages — the page's name, description, and SEO title and description.
  • Blog & collection entries — published entries' title, excerpt, and body (see collections).
  • Dataset records — a record's dataset values. A record only appears in results when a published page repeats over that dataset, so the result can link to a real page.

Results are listed in that order (pages, then entries, then records), up to 50 matches. There's no relevance ranking — matching is a straight substring test — so clear titles and descriptions make results more useful. The /search results page is excluded from search engines, and search is a reserved page slug.

The layout built-in pages use​

The results page is built for you, but the header, navigation and footer around it are yours. It renders inside one of your layouts, so a visitor who lands on /search gets the same site around them as on every other page.

Which layout is a setting: Setup → Built-in page layout. Left unset it follows the layout your home page uses, which is what most sites want and why there is nothing to do here on a site with a single layout. Pick a different one when your home page has a layout of its own — a transparent header meant to sit over a hero image looks wrong above a list of results.

The same setting covers the other page Aglyn builds for you: a blog entry on a collection with no entry template, so both built-in pages of a site cannot end up in different chrome.

Configure it​

The Search Box exposes two settings — its Placeholder text and Starting text, which prefills the field (the results page uses it to keep the query you searched for in the box). There are no scope, result-limit, or styling options; the box inherits your site theme.

How-tos