What is MIME type "application/x-chrome-package"?

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

application/x-chrome-package is a MIME type used for packaging extensions for Google Chrome.
It signals that the file is a Chrome Extension Package that the browser can install and run.

A packaged Chrome extension bundles code, images, and configuration files in one file. It is handled by the Chrome engine to extend browser capabilities.
This package is stored in the CRX format.

Main use: Installation of Chrome browser extensions.
Key facts:
- Contains all resources needed for the extension.
- Uses a cryptographic signature to verify integrity.
- Facilitates easy distribution and updates of extensions.
Other uses:
- Streamlines extension deployment within organizations.
- Supports secure third-party enhancements for Chrome.

For more technical details, check the Chrome Developer Documentation.

Associated file extensions

.crx

Usage Examples

HTTP Header

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


    Content-Type: application/x-chrome-package

HTML

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


    <a href="file.dat" type="application/x-chrome-package">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/x-chrome-package');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.crx

FAQs

How do I configure my server to handle application/x-chrome-package?

To ensure browsers recognize the file correctly, you must associate the MIME type with the .crx extension. For Apache, add AddType application/x-chrome-package .crx to your config or .htaccess file. For Nginx, add application/x-chrome-package crx; to your mime.types file.

What usually causes a CRX file download to fail or be blocked?

Modern versions of Google Chrome block extensions not hosted on the official Chrome Web Store for security reasons. If a server sends the application/x-chrome-package header, Chrome may download the file but prevent automatic installation, requiring the user to use Developer Mode to install it manually.

How do I manually install a file with this MIME type?

Navigate to chrome://extensions/ in your browser and toggle Developer mode on in the top right corner. Drag and drop the .crx file directly into the browser window to bypass standard store restrictions and install the package.

Is application/x-chrome-package compatible with browsers other than Chrome?

Yes, most Chromium-based browsers support this MIME type. This includes Microsoft Edge, Opera, Vivaldi, and Brave. However, browsers like Mozilla Firefox use a different format (.xpi) and do not process this MIME type.

What is the internal structure of an application/x-chrome-package file?

Under the hood, this file is a ZIP archive with a special binary header that includes a public key and a cryptographic signature. If you need to debug the contents, you can often rename the file extension to .zip and extract it using standard archiving tools.

Can I self-host files with the application/x-chrome-package type?

Yes, you can host these files on your own server for enterprise or private distribution. However, to enable auto-updates, you must also host an update manifest (XML) and ensure your server delivers the correct MIME type so the browser recognizes it as an installable package.

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.