Series Connections<\/a><\/li><\/ul><\/li><\/ul><\/nav><\/div>\n\n\n\nWhat a Template Actually Is (Django Template Language Explained)<\/h2>\n\n\n\n A template is just an HTML file that Django can fill in with data at the moment a page is requested, instead of that HTML living as a string inside a Python function. Django’s Template Language, usually shortened to DTL, is the small set of syntax rules that let a plain HTML file do things a plain HTML file normally can’t \u2014 starting, in this lesson, with displaying a value passed in from a view.<\/p>\n\n\n\n
It’s not a new programming language to learn from scratch. It’s a fairly small vocabulary layered on top of HTML, and Part 1 only covers the first piece of it.<\/p>\n\n\n\n
Step 1: Setting Up a Templates Folder<\/h2>\n\n\n\n Django looks for templates in a specific place. Inside your app, create this structure:<\/p>\n\n\n\n
blog\/\n templates\/\n blog\/\n home.html<\/code><\/pre>\n\n\n\nThat nested blog folder inside templates<\/code> looks redundant at first, but it exists to prevent naming collisions \u2014 if two different apps both have a home.html<\/code>, this structure keeps them from overwriting each other in Django’s lookup.<\/p>\n\n\n\nThen check settings.py<\/code>. By default, Django’s startproject<\/code> command already configures the TEMPLATES<\/code> setting to search inside each app’s templates<\/code> folder automatically, so in most cases nothing needs to change here \u2014 it’s just worth knowing this is the setting that makes the folder structure above actually work.<\/p>\n\n\n\nStep 2: Moving HTML Out of the View<\/h2>\n\n\n\n Take the homepage HTML you’ve been building through HttpResponse<\/code> and move it into home.html<\/code> almost exactly as it was:<\/p>\n\n\n\nhtml<\/p>\n\n\n\n
<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <title>My Django Site<\/title>\n<\/head>\n<body>\n <nav>\n <a href=\"\/\">Home<\/a>\n <a href=\"\/about\/\">About<\/a>\n <\/nav>\n\n <main>\n <h1>Welcome to my site<\/h1>\n <p>This homepage is now rendered from a real template file.<\/p>\n <\/main>\n\n <footer>\n <p>© 2026 My Django Site<\/p>\n <\/footer>\n<\/body>\n<\/html><\/code><\/pre>\n\n\n\nNotice this is plain HTML right now \u2014 no DTL syntax yet. That’s intentional, to show that a template is still just an HTML file first, before anything special gets added to it.<\/p>\n\n\n\n
Step 3: Rendering the Template From a View<\/h2>\n\n\n\n Update your home<\/code> view to use render()<\/code> instead of building the HTML manually:<\/p>\n\n\n\npython<\/p>\n\n\n\n
from django.shortcuts import render\n\ndef home(request):\n return render(request, 'pages\/home.html')<\/code><\/pre>\n\n\n\nThat’s the whole view now. render()<\/code> takes the request, finds the template by its path, and returns it as an HttpResponse<\/code> behind the scenes \u2014 you don’t have to build the response object by hand anymore. Refresh your browser, and the page should look identical to before, just coming from a file instead of a string.<\/p>\n\n\n\nStep 4: Displaying a Variable With DTL<\/h2>\n\n\n\n Here’s where DTL syntax actually shows up, and where this lesson stays focused. Update the view to pass some data along with the template:<\/p>\n\n\n\n
python<\/p>\n\n\n\n
def home(request):\n context = {\n 'site_name': 'My Django Site',\n }\n return render(request, 'pages\/home.html', context)<\/code><\/pre>\n\n\n\nThat dictionary is called the context. Now, inside home.html<\/code>, reference it using double curly braces:<\/p>\n\n\n\nhtml<\/p>\n\n\n\n
<h1>Welcome to {{ site_name }}<\/h1><\/code><\/pre>\n\n\n\nReload the page, and instead of hardcoded text, you’ll see whatever value the view passed in. That double-brace syntax, {{ variable_name }}<\/code>, is the core of DTL for this lesson \u2014 it’s how a template pulls in a Python value and displays it as text.<\/p>\n\n\n\nTry It With a Second Variable<\/h2>\n\n\n\n Add one more value to the context to get comfortable with the pattern before moving on:<\/p>\n\n\n\n
python<\/p>\n\n\n\n
def home(request):\n context = {\n 'site_name': 'My Django Site',\n 'tagline': 'Learning Django one lesson at a time.',\n }\n return render(request, 'pages\/home.html', context)<\/code><\/pre>\n\n\n\nhtml<\/p>\n\n\n\n
<h1>Welcome to {{ site_name }}<\/h1>\n<p>{{ tagline }}<\/p><\/code><\/pre>\n\n\n\nNothing complicated here, just repetition of the same idea \u2014 a Python value goes into the context dictionary, and {{ }}<\/code> pulls it into the HTML wherever it’s referenced.<\/p>\n\n\n\n[Screenshot spot: your rendered homepage showing both variables displaying correctly \u2014 worth noting what values you actually used.]<\/p>\n\n\n\n
What Hasn’t Been Covered Yet<\/h2>\n\n\n\n This post stops deliberately at variable display. Logic tags like {% if %}<\/code> and {% for %}<\/code>, along with template inheritance using {% extends %}<\/code> and {% block %}<\/code>, are both covered in separate lessons later in this series rather than rushed in here. Trying to absorb variables, conditionals, loops, and inheritance all in one sitting tends to blur together \u2014 keeping this one scoped to just {{ }}<\/code> makes it easier to actually retain.<\/p>\n\n\n\nA Mistake Worth Flagging Early<\/h2>\n\n\n\n If your template renders blank or throws a “TemplateDoesNotExist” error, the nested folder structure \u2014 templates\/pages\/home.html<\/code>, not just templates\/home.html<\/code> \u2014 is the first thing to check. It trips up almost everyone the first time, myself included.<\/p>\n\n\n\nSeries Connections<\/h2>\n\n\n\n This lesson replaces the HttpResponse<\/code>-based approach used throughout the earlier posts in this series, including the dynamic single post page tutorial \u2014 worth revisiting to see exactly what problem templates are solving. For the complete reference on variables and context beyond what’s covered here, the official Django documentation on the template language<\/a> is worth keeping open while practicing.<\/p>\n\n\n\nTry converting your About page to use render()<\/code> and a {{ }}<\/code> variable on your own before the next lesson. That repetition is what makes this piece stick before tags and inheritance get introduced.<\/p>\n\n\n\n
![\"Django](\"https:\/\/nayananimsara.online\/wp-content\/uploads\/2026\/09\/image-20.png\")
<\/figure>\n\n\n\n