What is MIME type "application/opensearchdescription+xml"?

A MIME type is a string that tells browsers and other tools how to handle a particular kind of file.

application/opensearchdescription+xml is a MIME type that specifies a file format using XML to describe a search engine's details. It tells browsers how to plug in a website’s search feature.

The file details the search URL, query parameters, and other settings. This lets browsers automatically configure search boxes without extra setup.

Discovery: Websites publish these files so browsers can detect and add new search engines.
Integration: It enables seamless search integration in browsers and applications.
Customization: It allows the definition of custom search parameters and icons.

This format supports a flexible and standardized approach to search integration. For more details, visit the OpenSearch official site.

Associated file extensions

.xml

Usage Examples

HTTP Header

When serving content with this MIME type, set the Content-Type header:


    Content-Type: application/opensearchdescription+xml

HTML

In HTML, you can specify the MIME type in various elements:


    <a href="file.dat" type="application/opensearchdescription+xml">Download file</a>

Server-side (Node.js)

Setting the Content-Type header in Node.js:


    const http = require('http');    
    
    http.createServer((req, res) => {    
      res.setHeader('Content-Type', 'application/opensearchdescription+xml');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.xml

FAQs

What is the primary use of application/opensearchdescription+xml?

This MIME type identifies an OpenSearch Description document. It tells web browsers that the associated XML file contains configuration details—such as the search URL and query parameters—allowing users to add the website's search engine directly to their browser's search bar.

How do I add OpenSearch autodiscovery to my website?

To enable autodiscovery, place a <link> tag in the <head> section of your HTML pages. The syntax is: <link rel="search" type="application/opensearchdescription+xml" href="/opensearch.xml" title="Site Name">. This signals the browser to look for the file defined by this MIME type.

Can I use text/xml instead of application/opensearchdescription+xml?

Technically, the content is XML, but browsers specifically look for application/opensearchdescription+xml to trigger search engine installation features. Using generic types like text/xml typically results in the browser simply displaying the code rather than offering to install the search plugin.

How do I configure Apache to serve this MIME type?

If your server isn't sending the correct header automatically, add the following line to your .htaccess file or main configuration: AddType application/opensearchdescription+xml .osdx .xml. This ensures the server explicitly associates the format with the file extension.

What file extensions are associated with this MIME type?

The most common extension is .xml, as the format is XML-based. However, the specific extension .osdx is sometimes used to distinguish OpenSearch files from generic XML files within a file system.

Why is my browser not detecting the search engine?

Common issues include a missing rel="search" tag in the HTML, malformed XML content, or the server sending the wrong Content-Type header. Use browser developer tools to verify that the file is being served as application/opensearchdescription+xml.

Are there security risks associated with OpenSearch files?

Since the file is XML, it must be parsed securely to avoid XML External Entity (XXE) vulnerabilities if processed by a backend server. On the client side, ensure the Url template in the file points to your legitimate domain to prevent redirecting users to malicious sites.

General FAQ

What is a MIME type?

A MIME (Multipurpose Internet Mail Extensions) type is a standard that indicates the nature and format of a document, file, or assortment of bytes. MIME types are defined and standardized in IETF's RFC 6838.

MIME types are important because they help browsers and servers understand how to process a file. When a browser receives a file from a server, it uses the MIME type to determine how to display or handle the content, whether it's an image to display, a PDF to open in a viewer, or a video to play.

MIME types consist of a type and a subtype, separated by a slash (e.g., text/html, image/jpeg, application/pdf). Some MIME types also include optional parameters.

How do I find the MIME type for a file?

You can check the file extension or use a file identification tool such as file --mime-type on the command line. Many programming languages also provide libraries to detect MIME types.

Why are multiple MIME types listed for one extension?

Different applications and historical conventions may use alternative MIME identifiers for the same kind of file. Showing them all helps ensure compatibility across systems.