PyCharm 2021.1 Help

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.

  1. Press Ctrl+Alt+S to open IDE settings and select Tools | Web Browsers.

  2. The Web Browsers 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.

  3. To activate a browser, select the checkbox next to its name. The browser will be added to the context menu of the Open in Browser 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 the Browse button and select the actual path in the dialog that opens.

When you select View | Open in Browser, 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 page. To change the order of browsers in the list, use the Up and Down buttons.

Configure custom browsers

  1. Press Ctrl+Alt+S to open IDE settings and select Tools | Web Browsers.

  2. Click the Add button 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 page, select the browser and click Icons actions edit 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 Icons actions edit 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://flags in Chrome.

Remove browsers from the list

  • Select the required browser and click Icons general remove 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 View | Open in Browser from the main menu or Open in Browser 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.

  1. Press Ctrl+Alt+S to open IDE settings and select Tools | Web Browsers.

  2. 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 Up and Down 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 the Browse button, 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 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 View | Open in Browser command on the main menu or the Open in Browser command on the context menu of the file.

Last modified: 18 May 2021