PyCharm 2018.2 Help

Debugging Django Templates


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.

py configuringTemplateLanguage

Debugging a Django template

  • 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 checkbox Suspend.

  • Debugging Jinja and Mako templates is not supported.

To debug a Django template, follow these general steps

  1. Place breakpoints in the desired lines of the Django templates:

    py breakpointInDjangoTemplate

  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 icons actions startDebugger svg 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:
Last modified: 21 November 2018

See Also