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
- 1 File types and download actions
- 2 Changing download actions
- 3 Adding download actions
- 4 Resetting download actions for all content types
File types and download actions
When you click on a link to download a file, you may see a dialog asking whether you want to save the file or open it with a specific application, if there is no download action already set for that file type. Thethe 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.)
When you tell Firefox to open or save a file and also check the option "Do this automatically for files like this from now on" in the "What should Firefox do with this file?" prompt,If Firefox does not have a set download action for a type of file, Firefox will save the file by default. If you select 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 panel Applications section of Firefox settings.
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 select .Click the menu button and select .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 about:preferences page. Any changes you've made will automatically be saved.
Set Firefox to ask you what to do for files with no set content type and download action
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 and download action., you will see a What should Firefox do with this file? prompt (
Adding download actions
Starting in Firefox version 101, when you choose 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.
In Firefox version 98 and above, 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:
- 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.)
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).
"Always Open Similar Files" option
When you selectfrom 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.
When you click on a link and Firefox doesn't have a content type and download action set up for that type of file, Firefox will ask you how to handle the file by showing you the following prompt:
"What should Firefox do with this file?" prompt
If you change the action for a defined file type to or if you select in the Applications section of Firefox settings ( for other files not listedsee above), you will see a What should Firefox do with this file? prompt for those downloaded files.
- 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: Saves the file to a temporary folder and opens itOpens 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 OptionsPreferencesSettings Preferences 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 This will add a new entry to the Content Type list of download actions. 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 in the Applications section of Firefox settings. You can click the button to choose an application installed on your computer to open the file.
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 manually deleting the file that stores these settings.
Open your profile folder:
Note: If you are unable to open or use Firefox, follow the instructions in Finding your profile without opening Firefox.
- Click the menu button , click ., and select From the . The Troubleshooting Information tab will open. menu, select
- Under the Application Basics section next to Profile FolderDirectory, click . A window will open that contains your profile folder.Your profile folder will open.
- Close Firefox. Click the Firefox menu and select .Click the Firefox menu at the top of the screen and select .Click the Firefox menu and select .
- Delete (or rename) the handlers.json file.
- Restart Firefox.