PyCharm 2017.1 Help

Debugging Django Templates

This feature is supported in the Professional edition only.

In this section:


PyCharm allows placing breakpoints to the lines of Django template files, at the lines with Django tags or expressions.


Django is specified as the project template language.

To do that, open the Project Settings dialog, under the Project Settings select page Python Template Languages, select project where the templates reside, and then choose Django from the Template Language drop-down list.


Debugging a Django template

To debug a Django template, follow these general steps

  1. Place breakpoints in the desired lines of the Django templates:
  2. Launch Django server in the Debug mode.

    This is how it's done:

    1. On the main menu, choose Run | Edit Configurations.
    2. If the desired Django Server run/debug configuration exists, select it, otherwise create a new one, as described in the section Creating and Editing Run/Debug Configuration.
    3. Then click the button /help/img/idea/2017.1/debug.png on the main toolbar, or press Shift+F9.

    PyCharm will open the template in your browser, and suspend at the breakpoints you've set.

    The Debugger session starts, and Debug tool window appears.

  3. In the Debug tool window, you can:
  • If you want to trace back exceptions that are raised in course of template debugging, open Breakpoints dialog,  and in the Django Exception Breakpoints tab, select the check box Suspend.
  • Debugging Jinja and Mako templates is not supported.

See Also

Last modified: 26 July 2017