SEO Tools

Free OpenSearch Description Generator

Create an OpenSearch description document that lets visitors add your site search to their browser's search bar. Define the short name, search URL template with {searchTerms} placeholder, favicon, and optional suggestions URL. Includes the HTML link tag for auto-discovery.

Loading tool...

What is OpenSearch Description Generator?

An OpenSearch description is an XML document that tells browsers how to search a website. When a browser detects the OpenSearch link tag, it offers to add the site's search as a search engine option. Users can then search the site directly from the browser address bar or search box without visiting the site first. Firefox, Edge, and some Chromium-based browsers support this feature.

quickAnswer

Generate an OpenSearch description XML file so browsers can add your site search as a search engine. Include a short name, search URL with {searchTerms} placeholder, and favicon URL. Add the link tag to your page head so browsers auto-discover the search plugin.

limitations

  • Safari does not support OpenSearch. The feature works primarily in Firefox and Chromium-based browsers. Consider it a progressive enhancement rather than a core search feature.
  • The OpenSearch 1.1 specification (2005) is old and has not been updated. The format is stable but lacks some modern search features like structured data integration.
  • The XML file must be served with the correct Content-Type header (application/opensearchdescription+xml). Some static hosts may not serve custom content types for XML files.

How to use this tool

  1. Enter a short name (max 16 characters) for the search engine and a brief description.
  2. Provide the search URL template with {searchTerms} as the placeholder for the user's query.
  3. Add a favicon URL and optionally a suggestions URL for search autocomplete.
  4. Copy the XML to opensearch.xml and add the link tag to every page's head section.

What you can use it for

  • Add site search to Firefox and Chromium-based browsers so users can search directly from the address bar.
  • Create an OpenSearch plugin for a documentation site or knowledge base with a dedicated search page.
  • Add search integration for a static site that uses a third-party search service like Algolia or a custom search endpoint.

Use cases

Practical examples

example

Documentation site search

A documentation site has a search page at /search?q=. Generate the OpenSearch XML with the search URL template https://docs.example.com/search?q={searchTerms}. Visitors using Firefox see the site in their search engine list and can search docs directly.

example

Static site with third-party search

A static site uses a third-party search service. The search URL might be https://search.example.com/search?query={searchTerms}&site=mysite. Generate the OpenSearch description to integrate this search into visitors' browsers.

Common mistakes

  • Forgetting to include {searchTerms} in the search URL template — without it, the browser cannot pass the user's query to the search page.
  • Using a relative URL for the favicon or not serving it over HTTPS — the favicon must be an absolute HTTPS URL.
  • Serving the XML file with the wrong Content-Type — it should be application/opensearchdescription+xml for browsers to recognize it.

verification

  1. Visit your site in Firefox and check the address bar for a green plus icon or search engine addition prompt after adding the link tag.
  2. Verify the XML file at https://yoursite.com/opensearch.xml returns Content-Type: application/opensearchdescription+xml using the browser DevTools Network tab.

FAQ

Questions about OpenSearch Description Generator

Which browsers support OpenSearch?

Firefox has the strongest support and actively encourages sites to add OpenSearch descriptions. Chromium-based browsers (Chrome, Edge, Brave) support OpenSearch but the user experience varies. Safari does not support OpenSearch. The link tag is harmless in unsupported browsers and provides a progressive enhancement for Firefox users.

Can I use POST instead of GET for the search method?

Yes, but GET is strongly recommended. GET-based search URLs are bookmarkable, shareable, and work with browser address bar autocomplete. POST-based search requires the browser to submit a form, which limits usability. Most site search implementations use GET with query parameters.

Do I need a suggestions URL?

No, the suggestions URL is optional. It enables search autocomplete suggestions as the user types in the browser search bar, similar to how Google suggests queries. To support suggestions, your server must return JSON in the OpenSearch Suggestions format. Most static sites skip this feature.

Related tools

More seo tools

Seo

AI Crawler robots.txt Builder

Build a robots.txt policy for AI crawlers. Choose from open, selective, or strict presets and block specific AI training bots while allowing search engines.

Open tool

Also try

Also try

Html

ARIA Live Region Generator

Generate accessible ARIA live region HTML snippets with role, aria-live, aria-atomic, and aria-relevant attributes. Includes optional JavaScript update function.

Open tool

Html

CSP Hash Generator

Generate CSP hash values for inline scripts and styles. Hash exact code content with SHA-256, SHA-384, or SHA-512 and get the matching CSP directive snippet.

Open tool