PyCharm 2025.2 Help

Language injections

Language injections let you work with pieces of code in other languages embedded in your code. When you inject a language (such as HTML, CSS, XML, RegExp, and so on) into a string literal, you get comprehensive coding assistance for the injected code even though it is not the main language of your project.

By default, the IDE injects a language temporarily. It means that if you delete the embedded element, the injection will be lost as well.

Add language injections

Add a persistent language injection

Use language injection comments (annotations) to add persistent fragments of injected languages.

  • Add a blank line before the target string literal, and type the following comment:

    # language=<language_ID>
    HTML injection comment

    For comments, use the syntax of the language you want to inject. Language IDs are generally intuitive, for example, SQL, RegExp, XML, HTML.

    You can also learn language IDs in settings. Press Ctrl+Alt+S to open settings and then select Editor | language Injections. Double-click an injection rule for a language; the language ID is specified in the ID field.

  • (Optional) Include a prefix or a suffix in your comment.

    // language=<language_ID> prefix=<prefix> suffix=<suffix>

    This is required if:

    • The string is an incomplete/partial SQL statement

    • The string is not used directly in one of our supported calls (such as select /where)

Edit injected language fragments

PyCharm allows you to edit injected language fragment in a dedicated editor.

Open the fragment editor

  1. Place the caret within the injected code piece and press Alt+Enter (or use the intention action icon Intention action icon).

  2. Select Edit <language ID> Fragment.

    PyCharm will open a dedicated editor section for editing the code with the injected language. This editor provides full coding assistance, including code completion, inspections, intentions and code style actions.

    Edit the HTML fragment in the dedicated editor

Cancel injections

Cancel a persistent language injection

To cancel a language injection, delete the comment (annotation) you used to introduce it.

    Cancel a temporary language injection

    1. Place the caret at the code fragment and press Alt+Enter (or use the intention action icon the Intention action button).

    2. Select Uninject language or reference.

    Disable the intention action bulb icon

    Do the following to hide the intention action icon Intention action icon in the editor:

    1. Press Ctrl+Alt+S to open settings and then select Editor | General | Appearance.

    2. Clear the Show intention bulb checkbox.

    3. Apply the changes and close the dialog.

    Configure rules for automatic injections

    In PyCharm, there is a set of predefined rules according to which the IDE automatically injects languages in certain places in your code.

    You can configure language injection rules on the Editor | Language Injections settings page  Ctrl+Alt+S.

    Language injection settings

    All pre-defined injection rules are configured for the Built-in scope. In other words, they are global (and therefore available in all PyCharm projects). Custom rules can be configured for the IDE or for one project only. To change the scope of custom injections, use the the Move to Project/IDE scope button.

    To share a custom rule through VCS, move it to the Project scope using the corresponding option on the toolbar. By doing so, you will create a new file in the .idea directory named IntelliLang.xml with your custom rules that you can place under version control.

    If you don’t use a VCS, you can share your rules by exporting them to XML files (click Export on the toolbar) and then importing them to another project.

    To configure custom injection rules, click the Add button to add a new rule, or copy a predefined rule and change its settings.

    24 June 2025
    TODO commentsScratch files