Site search, powered by Google.

The Poper Search widget does not build or host its own search index. Instead it runs on Google Programmable Search, formerly known as Google Custom Search. You create a free Programmable Search Engine in Google's control panel, tell Google which site or sites it should cover, and generate an API key in the Google Cloud Console. In the widget's Content tab you paste the Search Engine ID and the API key, and Poper verifies and stores them on its servers, never sending them to the browser. From then on, when a visitor searches, the widget queries your Programmable Search Engine and renders the results inside your own branded layout. The practical consequence is that there is nothing for you to index or keep in sync: Google already crawls your pages as part of its normal web crawl, so a new page becomes searchable once Google has crawled and indexed it. You are getting Google-quality ranking and freshness without running a crawler, a database, or a sync pipeline of your own.

The Poper Search widget ships nine layouts, and you pick one in the Templates tab. Minimal Inline is a clean input that suits blogs and docs. Smart Suggestions shows quick-search chips you define under the bar, so a visitor starts from a useful query. Command Palette opens a full overlay on a Cmd+K or Ctrl+K shortcut, the pattern technical and power users expect from tools like Linear and Notion. Floating FAB is a fixed corner button that opens search on click. Sidebar Panel slides a search panel in from the side. AI Summary adds a short generated summary above the results. Category Tabs shows category buttons above the bar, and Filters Panel shows category buttons inside the search overlay; in both, picking a category scopes the next query to that area. Inline Button is a search input paired with a labelled button. Pick the layout by how your visitors search: an inline or button layout for casual visitors who want to get back to reading, the Command Palette for keyboard-first power users, and Category Tabs or Filters Panel when visitors benefit from narrowing to a section of the site.

A blank search box asks the visitor to know exactly what to type. Two features in the Poper Search widget reduce that burden. The first is suggestions: on the Smart Suggestions layout you define a list of quick-search chips, such as your most common queries, and a visitor can click one instead of typing. The second is categories: on the Category Tabs and Filters Panel layouts you define a list of categories, and when a visitor selects one, the widget scopes their query to that category by adding it to the search terms. This is not a faceted filter system with synonym dictionaries or numeric ranges; it is a straightforward way to point a visitor at a slice of your site, which is exactly what most content and documentation sites need. Choose suggestion chips that reflect what visitors most often look for, and keep your category list short so the choices stay scannable. Both lists are edited in the Content tab and update without a re-embed.

Eight of the nine layouts return a ranked list of result cards, each with a thumbnail, a title, and a snippet, which is the familiar search-results pattern. The ninth, AI Summary, adds something on top. When a visitor searches with the AI Summary layout, the widget takes the top results and generates a short summary that appears above the result list, so a visitor who just wants a quick answer to a common question can read it without opening a page. The full result list still appears below the summary, so a visitor who wants to dig deeper can. This layout suits a help center or knowledge base, where many queries are questions that have a short answer. For a documentation site or a store, where the visitor usually wants to land on a specific page or product, one of the ranked-list layouts is usually the better fit. As with any generated text, treat the AI summary as a helpful starting point rather than a guaranteed-correct answer, and make sure the underlying pages it draws from are accurate.

There are three common ways to add search to a site, and the Poper Search widget sits deliberately in the middle. The first way is the raw Google Programmable Search embed: it is free and uses Google's index, but it renders Google-branded results in a box you cannot really style, which looks bolted-on. The second way is a heavyweight hosted search platform with its own index: it gives you full design control, but you pay a developer to integrate it, configure index settings, and wire record-pushing into every publish, and the bill scales with index size and query volume. The Poper Search widget takes the index quality of the first option and the design control of the second, without the cost of either. It uses Google's index, which you connect once, so there is no index to build or maintain, and it renders the results in nine fully brandable layouts that look like part of your site, with no provider logo. Because it is part of the Poper widget suite, it also sits alongside your popups, forms, quizzes, and other widgets on one platform and one bill, instead of being a separate vendor to manage.