Manage file types and download actions in Firefox

This article describes how Firefox handles downloaded files for different types of content, such as saving a file or opening an application installed on your computer, and how you can change that behavior.

File types and download actions

When you click on a link to download a file, the Media type, also called the MIME type or Content type, as configured by the web server, will determine what action Firefox will take.

Firefox will not be able to properly handle a file if a misconfigured web server sends it with an incorrect content type. For example, Firefox may display the content as plain text instead of opening the file in an application. To learn more, see Properly configuring server MIME types and Common MIME types at MDN web docs. You can contact the website in such cases, or you can try a Firefox add-on such as Content-Type Fixer to work around the problem. (If you use an add-on and need help with it, you should visit the add-on site or contact the add-on developer for support.)

If Firefox does not have a set download action for a type of file, Firefox will save the file by default. If you select Always Open Similar Files in the Downloads panel right-click context menu for the file, (see below) a new Content Type and Action entry will be added to the General panel Applications section of Firefox settings.

Note: Firefox treats links to some types of media files, such as .mp3 files, the same way it treats .txt and .html links, by handling them internally. The file will not be downloaded and the Downloads panel will not open. Instead, the file will open and play in Firefox, with a control bar displayed to manage playback (see this article for details). Firefox only uses Applications settings to determine what action is taken when a file is treated as a download (see below).

Changing download actions

You can change what action Firefox takes for defined content types. This will not affect media embedded in a web page – only links to the files themselves.

  1. In the Menu bar at the top of the screen, click Firefox and then select Preferences or Settings, depending on your macOS version.Click the menu button Fx89menuButton and select Settings.
  2. In the General panel, go to the Applications section.
  3. Select the Content Type entry for action you want to change. (You might see more than one entry for the same file format or extension because some types of files include multiple content types.)
  4. The Action column will give you a drop-down menu, with options on the action to take.
    Fx77Applications-PDF-MacFx78Applications-PDFFx91Applications-PDF-Win
    • Open in Firefox: Select this if you want Firefox to display the content. It only applies to a limited number of content types that Firefox is able to decode (PDF, AVIF, XML, SVG, and WebP Image).
    • Always ask: This will show you a prompt asking What should Firefox do with this file? (see below) so that you can choose the action you want to take. This can be useful if Firefox is automatically saving that type of file or is always opening it with a certain application, and you want to be asked what to do.
    • Save File: This will always save the file to your computer, when you download that type of file. To learn more, see Where to find and manage downloaded files in Firefox.
    • Use WindowsmacOSsystem default application: This will open the file with the default application configured in your operating system. This is only shown for content types that include the Open in Firefox option (PDF, AVIF, XML, SVG, and WebP Image files) and is available when your system has another application set to open that type of file by default.
    • Use <application name>: Open the file or handle the protocol with this application. (Some Content Types, such as mailto, irc and ircs, are protocols, not types of files.) Options can include one or more web applications to handle the protocol or an installed application.
    • Use other…: This opens the Select Helper Application dialog, where you can choose the application you wish to use.
    • Application Details…: If web applications, or if installed applications other than the system default are listed, this opens a dialog where you can learn the location of those applications or remove an application as an available option.
  5. Close the Settings page. Any changes you've made will automatically be saved.

Set Firefox to ask you what to do for files with no defined content type

When you click on a link to download a file and Firefox doesn't have a content type and download action set up for that type of file, Firefox will save the file by default. If you want Firefox to ask you what to do with these downloads, you can go to the bottom of the Applications section under What should Firefox do with other files? and select Ask whether to open or save files.

Fx101settings-Applications-OtherFiles

When you choose the setting Ask whether to open or save files, you will see a What should Firefox do with this file? prompt (see below) when you download any file that has no defined content type.

Adding download actions

When you choose Ask whether to open or save files in Firefox settings under Applications (as shown above) and you download a file with no defined content type and action, you will see a What should Firefox do with this file? prompt. When you choose an action and also select the option, Do this automatically for files like this from now on, a new Content Type and Action entry will be added to the Applications list for that type of file. See the "What should Firefox do with this file?" prompt section below, for more information.

When you download a type of file that can be opened with an installed application you can set Firefox to always open similar files as follows:

  1. Right-clickHold down the control key while you click the downloaded item in the Downloads panel. (You can also do this from the Library window Downloads history.)
  2. Select Always Open Similar Files from the context menu.
    • This option may be missing in some cases, such as for executable files or files served by the website with an incorrect content type (see above).
    Fx98Downloads-FileContextMenu

"Always Open Similar Files" option

When you select Always Open Similar Files from the context menu for a downloaded item, the file will open in the system default application and a new Content Type entry will be added to the Applications section of Firefox settings, with the download action set to use that application. The next time you download that type of file and open the context menu, the Always Open Similar Files option will be check marked.

Fx98AlwaysOpenSimilarFilesCheckmark

If you clear the check mark, the download action for that Content Type in the Applications section of Firefox settings will be changed to Save File. You can later select a different action in Firefox settings (see above) if you wish, such as Use other… to choose a different application, or Always ask so that Firefox asks you what to do when you download that type of file.

Note: When you open a file in Firefox with an application, the file is also saved to the folder location shown next to Save files to: in the Downloads section under Files and Applications in Firefox settings (see Where to find and manage downloaded files in Firefox for details). To learn more about how file downloads are handled, see this article.

"What should Firefox do with this file?" prompt

If you change the action for a defined file type to Always ask or if you select Ask whether to open or save files for other files not listed in the Applications section of Firefox settings (see above), you will see a What should Firefox do with this file? prompt for those downloaded files.

Fx98prompt-OpenWithFirefox
  • Open with Firefox: Opens the file in Firefox. This option will only be shown for those content types that include an Open in Firefox option in the Applications section of Firefox settings (PDF, AVIF, XML, SVG, and WebP Image files).
  • Open with: Opens the file in the operating system's default application for that file type. (You can also use the drop-down menu to choose another application.)
  • Save File: Saves the file to the download folder (specified in your Firefox settings, in the General panel Downloads section).
  • Do this automatically for files like this from now on: Check mark this option to always take the selected action and then click OK. You may need to restart Firefox for the download action change to take effect.
Warning: Do not choose Firefox as a helper application to always open the file type, as this can cause a problem where Firefox repeatedly opens empty tabs or windows after you click on a link.

"What should Firefox do with this file?" prompt does not show an application

The "What should Firefox do with this file?" prompt may not show a default application for some file types you download, when you have Firefox set to Ask whether to open or save files in the Applications section of Firefox settings. You can click the Choose…Browse… button to choose an application installed on your computer to open the file.

Fx78OpeningPPTfileFx90OpeningFileChoose-mac

Resetting download actions for all content types

If you are having problems with how Firefox is handling file downloads that you can't resolve, or if you just want to start fresh, you can restore the default content types and actions by refreshing Firefox. To learn more, see Refresh Firefox - reset add-ons and settings.

Was this article helpful?

Please wait...

These fine people helped write this article:

Illustration of hands

Volunteer

Grow and share your expertise with others. Answer questions and improve our knowledge base.

Learn More