{# Page assets live INSIDE the content block (the dj-root): dj-navigate swaps only that region, so anything in extra_head/extra_scripts is missing when a visitor arrives by live navigation. Behaviour lives in static/js/site-pages.js. #}

DJE-020 Warning Template

wrapper_template renders with empty context

Error message

Template renders but shows no data — no error raised

If a LiveView's wrapper_template references context variables that were never set in mount() or handle_event(), the template renders silently with empty values. There is no error or warning, making it hard to diagnose why the page appears blank.

silent-failure template

Affected versions: >=0.2.0

Solution

Recommended

Always initialize all template context in mount()

Explicitly set all context variables in mount() with sensible defaults. This makes it clear what the template expects and prevents silent empty renders.

Before (problematic)

class DashboardView(LiveView):
    template_name = "dashboard.html"

    def mount(self, request):
        # Forgot to set self.items!
        pass

    # Template: {% for item in items %} ... renders nothing

After (fixed)

class DashboardView(LiveView):
    template_name = "dashboard.html"
    items = []  # Explicit default

    def mount(self, request):
        self.items = Item.objects.filter(
            user=request.user
        ).values("name", "status")

Back to Error Reference