Search is the fastest path between a curious visitor and the exact page they came for. Yet on most WordPress sites the built-in search is slow, reloads the whole page, and misses posts because of a single accent or a missing letter. This guide introduces a lightweight text and voice search box for WordPress that you can add to any site in a couple of minutes — and download for free. It works in every language, understands spoken queries, and never sends your visitors to a blank “no results” page when a close match exists.

Below you will find a complete, SEO-friendly review: what the tool does, why it helps both your readers and your rankings, a picture-by-picture installation walkthrough (including exactly what to change in the settings), how to download it, which browsers support voice, and answers to the questions people ask most.

When visitors can find what they want, they stay longer, read more pages, and are far less likely to bounce back to the search results. Those behavioral signals — longer sessions, more pages per visit, lower pogo-sticking — are exactly the signals that correlate with healthy rankings.

Voice adds a second dimension. Spoken search has moved from novelty to habit, especially on phones, where a large and growing share of queries are voice-driven. Offering voice on your own site meets that expectation and keeps mobile visitors engaged instead of fighting with a tiny on-screen keyboard. There is also an accessibility benefit that quietly widens your reach: voice input helps people who find typing difficult, who have limited mobility, or who are simply searching on the move.

Finally, fast internal search encourages discovery. When a reader finishes one article and immediately finds three related ones, your average time on site rises and your content gets more of the attention it deserves. And every search your visitors run is an honest signal of what they expected to find — queries that come back empty point straight at gaps in your content, giving you a ready-made list of posts to write next. Good search is not just a convenience; it is a quiet engine for both retention and content ideas.

Here is the complete settings block exactly as it appears at the top of the file. Every line is optional and already set to a sensible default — edit only what you want to change:

window.WSR_CONFIG = {

  /* ---- 1. SITE ---- */
  SITE_URL    : "",        // "" = this site. Fill only if the widget is on another domain: "https://www.your-site.com"

  /* ---- 2. LANGUAGE ---- */
  LANG        : "auto",    // "auto" = site language. Or force one: "ar", "ar-MA", "fr", "en-US", "es", "de", "zh-CN"...
  VOICE_LANGS : [],        // several voice languages, e.g. ["ar-SA","en-US","fr-FR"] shows a switch by the mic
  DIR         : "auto",    // "auto" | "ltr" | "rtl"
  PLACEHOLDER : "",        // "" = translated automatically, or write your own text

  /* ---- 3. SEARCH ---- */
  TYPES       : ["posts"], // ["posts"], ["posts","pages"], or a custom type e.g. ["posts","product"]
  QUERY       : "",        // extra REST filters: "categories=3,7", "lang=fr" (Polylang), "exclude=12"...
  MAX         : 20,        // number of results shown
  PAGES       : 5,         // pages of 100 posts cached (5 = 500). Bigger sites also get a live server search
  PRELOAD     : false,     // true = load posts on page load (instant first search)
  ALL_LINK    : true,      // "Search the whole site" link (/?s=) under the results
  NEW_TAB     : false,     // true = open results in a new tab
  HOTKEY      : "",        // keyboard shortcut that focuses the box, e.g. "/"

  /* ---- 4. LOOK ---- */
  THEME       : "light",   // "light" | "dark" | "auto" (follows the visitor's system)
  ACCENT      : "",        // "" = Google blue, or any color e.g. "#0f9d58"
  MAX_WIDTH   : "600px",   // "100%" to fill the container
  DATES       : true,      // show the post date
  OVERLAY     : false      // true = results float over the page (for headers)
};

And here is what each setting does, grouped the same way:

Where to place the widget

Drop it wherever your visitors look for search.

No. The search box reads your site language automatically and uses it for both the interface and voice recognition. An Arabic site gets Arabic voice, a French site gets French voice, and so on, with no editing at all.

One technical fact helps here: the browser’s speech engine cannot detect which language a person is speaking, and it can only listen for one language per session — a limitation of the technology, not of this tool. What the search box does is remove the manual work: instead of asking you to hard-code a language, it picks the right one from your site settings. For a genuinely bilingual audience, the VOICE_LANGS option shows a small language switch next to the microphone so visitors choose; for a normal single-language site everything is automatic.

This automatic approach matters most on mobile, where voice is used far more than on desktop and where typing long or non-Latin queries is slow. A visitor can tap the microphone, say a few words in their own language, and reach the right article without touching the keyboard — and thanks to the accent, mark and typo tolerance, even a slightly misheard word still lands on the correct result.

A great search box is one of the highest-return additions you can make to a content site. It shortens the distance between a visitor’s question and your answer, keeps mobile and voice-first users engaged, and quietly improves the engagement signals that support your rankings. This WordPress Universal Search box delivers all of that in a single, free, paste-once block — instant text search, automatic multilingual voice, accent and typo tolerance, and a clean, accessible design that respects your theme in both light and dark modes.

If your current search sends readers to dead ends or forces a page reload for every query, this is a simple upgrade worth making today. Download the search box for free, drop it into a Custom HTML block, and give your visitors a faster, friendlier way to find exactly what they came for.