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.
- For help with problems downloading files, see What to do if you can't download or save files.
- For help with embedded media on web pages, see Fix common audio and video issues.
- For help changing the e-mail program Firefox uses, see Change the program used to open email links.
Table of Contents
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 see below) a new Content Type and Action entry will be added to the panel Applications section of Firefox settings.
in the Downloads panel right-click context menu for the file, (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.
- In the Menu bar at the top of the screen, click and then select or , depending on your macOS version.Click the menu button and select .
- In the panel, go to the Applications section.
- 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.)
- The Action column will give you a drop-down menu, with options on the action to take.
- 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.
- Close the 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
.When you choose the setting see below) when you download any file that has no defined content type.
, you will see a What should Firefox do with this file? prompt (Adding download actions
When you choose "What should Firefox do with this file?" prompt section below, for more information.
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 theWhen 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:
- 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.)
- Select
- 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).
from the context menu.
"Always Open Similar Files" option
When you select
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 option will be check marked.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 to choose a different application, or so that Firefox asks you what to do when you download that type of file.
"What should Firefox do with this file?" prompt
If you change the action for a defined file type to see above), you will see a What should Firefox do with this file? prompt for those downloaded files.
or if you select for other files not listed in the Applications section of Firefox settings (- 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 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 . You may need to restart Firefox for the download action change to take effect.
"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 button to choose an application installed on your computer to open the file.
in the Applications section of Firefox settings. You can click theResetting 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.