Configure browsers
PyCharm is shipped with a predefined list of most popular browsers that you may install and launch automatically from the IDE during running, debugging, or previewing the output of an HTML file. PyCharm presumes that you install browsers according to a standard procedure and assigns each installation an alias which stands for the default path to the browser's executable file or macOS application. In addition to the browsers from the default list, you can configure custom browser installations.
PyCharm has a built-in web server that can be used to preview and debug your application. This server is always running and does not require any manual configuration. All the project files are served on the built-in server with the root URL http://localhost:<built-in server port>/<project root>, with respect to the project structure.
By default the built-in server port is set to the default PyCharm port 63342 through which PyCharm accepts connections from services. To change this default value, open the Settings/Preferences dialog (Ctrl+Alt+S), go to , and in the Built-in Server specify any other value starting from 1024.
Press Ctrl+Alt+S to open the IDE settings and select .
The Web Browsers and Preview page that opens shows the browsers from the predefined list and the previously configured custom browser installations, if any. For each browser, PyCharm shows its name, the family to which it belongs, and the path to the browser's executable file/macOS application or the predefined alias that stands for this path.
To activate a browser, select the checkbox next to its name. The browser will be added to the context menu of the menu item and its icon will be displayed in the browser icons popup.
If the browser was installed according to a standard installation procedure, most likely the alias in the Path field points at the right location. If it does not, click
and select the actual path in the dialog that opens.
When you select , or press Alt+F2, or invoke the browser icons bar, the available browsers are shown in the order in which they are listed on the Web Browsers and Preview page. To change the order of browsers in the list, use the 
and 
buttons.
Configure custom browsers
Press Ctrl+Alt+S to open the IDE settings and select .
Click
on the toolbar and in the new row specify the browser name, family, and the path to its executable or macOS application.
Use a custom profile
For Firefox and browsers of the Chrome family, you can use a custom profile.
On the Web Browsers and Preview page, select the browser and click
on the toolbar. Depending on the family of the selected browser, the Firefox Settings or Chrome Settings dialog opens.For Firefox, specify the path to the required profiles.ini file and choose the profile to use from the list. Learn more at Firefox browser profile.
For Chrome, select the Use custom user data directory checkbox and specify the location of your user data directory in the PyCharm settings.
To launch a browser of the Chrome family with additional options, click
on the toolbar and type the required keys in the Command Line Options field of the Chrome Settings dialog that opens. Learn more about Chrome command-line options by opening chrome://flagsin Chrome.
Remove browsers from the list
Select the required browser and click
on the toolbar. Note that only custom browsers can be removed.
Choose the default PyCharm browser
When you want to preview your application output in the browser by choosing from the main menu or from the context menu of a file, you need to choose the browser to open the preview in. You can use a specific browser from the context menu or choose Default Browser.
PyCharm also opens the PyCharm default browser to render external resources.
Press Ctrl+Alt+S to open the IDE settings and select .
From the Default Browser list, choose the browser to use by default for previewing pages.
To use the default operating system browser, choose System default.
To use the browser on top of the list, choose First listed. Change the order or browsers using the
and icons on the toolbar.To use another browser as default, choose Custom path and specify the location of the executable file of the required browser. Type the path manually or use Browse
, if necessary.
Configure the browser icons popup
By default, the browser icons popup appears only in HTML files. In XML files, the popup by default does not show up to help you read and edit your code without distraction.
To have the popup displayed or hidden in HTML or XML files, go to the Tools | Web Browsers and Preview page of the IDE settings Ctrl+Alt+S and use the For HTML files and For XML files checkboxes in the Show browser popup in the editor area.
If you configure the popup to be hidden in HTML or XML files, you can preview files of the corresponding type using the command on the main menu or the command on the context menu of the file.
Configure automatic reload of HTML pages
By default, after you open an HTML file in the browser or in the built-in preview, PyCharm automatically reloads the page every time this HTML file (or any linked JavaScript or Style Sheet file) is saved manually or automatically, see Save and revert changes.
You can change the default behavior to reload the page as you type so the changes to the HTML or related file immediately appear in the browser or in the built-in preview.
Go to the Tools | Web Browsers and Preview page of the IDE settings Ctrl+Alt+S. Alternatively, click Configure in the Got it tooltip.
In the Reload behavior area, from the Reload page in browser and Reload page in built-in preview lists, select the actions that will trigger automatic reload of pages in web browsers and in the built-in preview. By default, On Save is selected.
Select On Change to reload pages as you update the corresponding HTML file or linked files.
Select Disabled to suppress automatic upload.
For details and examples, see Configure automatic reload.