Fix TemplateDoesNotExist: TemplateDoesNotExist at /dashboard/ — dashboard/index.html in Django

This error means Django cannot find the specified template file in any of its configured template directories. Fix it by verifying the TEMPLATES setting includes your app's directories, ensuring APP_DIRS is True, and checking that the template file path matches the string passed to render() exactly, including subdirectory names.

Reading the Stack Trace

Here's what each line means:

• File "/app/dashboard/views.py", line 8, in index: Your view passes 'dashboard/index.html' to render(), but Django cannot locate this template anywhere on its search path.
• File "/venv/lib/python3.11/site-packages/django/template/loader.py", line 19, in get_template: Django's template loader tried all configured backends and directories but found no matching file.
• raise TemplateDoesNotExist(template_name, chain=chain): The chain variable lists every loader that was tried, which is useful for debugging which directories were searched.

Common Causes

# settings.py
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': False,  # Templates inside apps are not discovered
        'OPTIONS': { ... },
    },
]

# File is at dashboard/index.html instead of dashboard/templates/dashboard/index.html
# views.py
def index(request):
    return render(request, 'dashboard/index.html')

# settings.py
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    # 'dashboard',  # Missing!
]

The Fix

Place the template at dashboard/templates/dashboard/index.html so Django's app-directory loader can find it. Enable APP_DIRS and add the app to INSTALLED_APPS. The double directory naming (dashboard/templates/dashboard/) is a Django convention to namespace templates.

# dashboard/views.py
def index(request):
    return render(request, 'dashboard/index.html')

# Template file located at: dashboard/index.html  (WRONG)

# 1. Move template to correct location:
#    dashboard/templates/dashboard/index.html

# 2. Ensure app is in INSTALLED_APPS:
# settings.py
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'dashboard',  # Added
]

# 3. Ensure APP_DIRS is True:
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates'],
        'APP_DIRS': True,
        'OPTIONS': { ... },
    },
]

Testing the Fix

import pytest
from django.test import TestCase, Client


class TestDashboardTemplate(TestCase):
    def setUp(self):
        self.client = Client()

    def test_dashboard_index_renders(self):
        response = self.client.get('/dashboard/')
        assert response.status_code == 200
        self.assertTemplateUsed(response, 'dashboard/index.html')

    def test_dashboard_index_contains_expected_content(self):
        response = self.client.get('/dashboard/')
        assert response.status_code == 200
        self.assertContains(response, '<div')

    def test_template_exists(self):
        from django.template.loader import get_template
        template = get_template('dashboard/index.html')
        assert template is not None

Run your tests:

pytest

Pushing Through CI/CD

git checkout -b fix/template-not-found-dashboard,git add dashboard/templates/dashboard/index.html settings.py,git commit -m "fix: move template to correct directory and enable APP_DIRS",git push origin fix/template-not-found-dashboard

Your CI config should look something like this:

name: CI
on:
  pull_request:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
          cache: 'pip'
      - run: pip install -r requirements.txt
      - run: python manage.py check --deploy
      - run: pytest --tb=short -q

The Full Manual Process: 18 Steps

Here's every step you just went through to fix this one bug:

1. Notice the error alert or see it in your monitoring tool
2. Open the error dashboard and read the stack trace
3. Identify the file and line number from the stack trace
4. Open your IDE and navigate to the file
5. Read the surrounding code to understand context
6. Reproduce the error locally
7. Identify the root cause
8. Write the fix
9. Run the test suite locally
10. Fix any failing tests
11. Write new tests covering the edge case
12. Run the full test suite again
13. Create a new git branch
14. Commit and push your changes
15. Open a pull request
16. Wait for code review
17. Merge and deploy to production
18. Monitor production to confirm the error is resolved

Total time: 30-60 minutes. For one bug.

pip install bugstack

import bugstack

bugstack.init(api_key=os.environ["BUGSTACK_API_KEY"])

Deploying the Fix (Manual Path)

1. Run the full test suite locally to confirm the template renders.
2. Open a pull request with the template relocation and settings change.
3. Wait for CI checks to pass on the PR.
4. Have a teammate review and approve the PR.
5. Merge to main and verify the deployment in staging before promoting to production.

Frequently Asked Questions