IntelliJ IDEA
 
2023.3
Shortcuts: Windows
Get IntelliJ IDEA
You are viewing the documentation for an earlier version of IntelliJ IDEA.
Upcoming webinar
Gatherers: The API Your Stream Was Missing
March 13, 2025 at 03:00 PM
  1. Non-JVM technologies
  2. Python
  3. Django support
  4. Work with Django templates
  5. Create and use custom template tags

Create and use custom template tags

Last modified: 11 February 2024

With Django you can set up a new tag to introduce a functionality that is not covered by the built-in template tags. IntelliJ IDEA provides you with corresponding code and navigation assistance.

Create a custom template tag

  1. Under the application directory, create the templatetags package (it should contain the __init__.py file). For example, Django/DjangoApp/templatetags.

  2. In the templatetags package, create a .py file, for example my_custom_tags, and add some code to it to declare a custom tag.

    For more information about custom template tags coding practices, refer to Django documentation.

    Adding a custom template tag

Add a custom template tag to a template

  1. Open you template file in the editor and add the corresponding template tag to it.

    Unresolved reference

    IntelliJ IDEA displays the Unresolved tag inspection error because you have not loaded the custom tag into the template file.

  2. Use a quick-fix to resolve the missing reference. Place the caret at the custom tag name, press AltEnter, and select the file to load.

    Inspections to load a custom template

    IntelliJ IDEA adds the {% load %} tag to the template file to fix the reference.

    Tag implementation name completion

IntelliJ IDEA also recognizes custom template tags that are recorded as builtins tags in the TEMPLATES section of the settings.py file.

Navigating to the tag implementation

Once you record a custom tag in the settings file, you can navigate to the file with its declaration. Place the caret at the template tag filename and press Ctrl0B.