# Circular Imports

URL: /docs/troubleshooting/circular-imports/
Section: troubleshooting
Tags: troubleshooting, circular import, macros

--------------------------------------------------------------------------------

Circular Imports When using &#123;% from &quot;template.html&quot; import macro_name %&#125;, a template must not import from itself (directly or transitively). Kida detects this and raises TemplateRuntimeError with code K-TPL-003 instead of hitting Python's recursion limit. The Error TemplateRuntimeError: Circular import detected: 'showcase/_tab_content.html' imports itself (via showcase/_tab_content.html) Location: showcase/_tab_content.html:1 Code: K-TPL-003 Cause A template has &#123;% from &quot;X&quot; import y %&#125; where X is the same template or leads back to it: {# BAD: _tab_content.html imports from itself #} &#123;% from &quot;showcase/_tab_content.html&quot; import tab_section %&#125; &#123;% def tab_section() %&#125;content&#123;% end %&#125; Or transitive: A imports B, B imports A. Fix Split macros into a separate file and import from there: {# _tab_section.html — macros only #} &#123;% def tab_section() %&#125;content&#123;% end %&#125; {# _tab_content.html — imports from sibling #} &#123;% from &quot;showcase/_tab_section.html&quot; import tab_section %&#125; &#123;% block tab_content %&#125; {{ tab_section() }} &#123;% end %&#125; See Also Functions and macros — &#123;% def %&#125; and &#123;% from %&#125; render_block and def scope — Blocks do not inherit defs from the same template

--------------------------------------------------------------------------------

Metadata:
- Word Count: 171
- Reading Time: 1 minutes