Variable substitution syntax in Flask

Introduction

Variable substitution lets you show dynamic data inside your web pages easily. It replaces placeholders with real values when the page loads.

Showing a user's name on a welcome page.

Displaying a list of items from a database.

Updating page content based on user input.

Showing the current date or time dynamically.

Syntax

Flask

{{ variable_name }}

Use double curly braces {{ }} to insert variables.

Variables come from the Flask code you send to the template.

Examples

Shows the value of the variable username in the page.

Flask

{{ username }}

Shows the age property of the user object.

Flask

{{ user.age }}

Shows the result of a simple expression, here it will show 8.

Flask

{{ 5 + 3 }}

Concatenates strings and variables to show a greeting.

Flask

{{ 'Hello ' + username }}

Sample Program

This Flask app shows how to use variable substitution to greet a user by name. The variable name is replaced with the value of user_name when rendering the page.

Flask

from flask import Flask, render_template_string

app = Flask(__name__)

@app.route('/')
def home():
    user_name = 'Alice'
    html = '''
    <html lang="en">
    <head><title>Welcome</title></head>
    <body>
        <h1>Welcome, {{ name }}!</h1>
        <p>We are glad to see you.</p>
    </body>
    </html>
    '''
    return render_template_string(html, name=user_name)

if __name__ == '__main__':
    app.run(debug=False, port=5000)

Important Notes

Variable substitution is safe by default: Flask escapes HTML to prevent security issues.

You can use filters like {{ variable|upper }} to change output style.

Common mistake: forgetting to pass the variable from Flask to the template causes empty output.

Summary

Use {{ variable }} to insert dynamic data in Flask templates.

Variables come from your Flask code when rendering the template.

This makes your web pages interactive and personalized.

Practice

1. In Flask templates, which syntax correctly inserts the value of a variable named username into the HTML?

easy

A. [[ username ]]

B. {{ username }}

C. {% username %}

D. <% username %>

Solution

1. Step 1: Understand Flask template syntax

   Flask uses Jinja2 templating where variables are inserted using double curly braces {{ variable }}.

2. Step 2: Identify correct variable substitution

   The correct way to show the value of username is {{ username }}.

3. Final Answer:

   {{ username }} -> Option B

4. Quick Check:

   Variable substitution = {{ username }} [OK]

Hint: Use double curly braces {{ }} for variables in Flask templates [OK]

Common Mistakes:

• Using {% %} which is for control statements
• Using brackets like [[ ]] which is not Flask syntax
• Using <% %> which is from other template engines

2. Which of the following is the correct syntax to display a variable age inside a Flask template?

easy

A. {{ age }}

B. {% age %}

C. <%= age %>

D. [[ age ]]

Solution

1. Step 1: Recall Flask variable syntax

   Flask templates use Jinja2 syntax where variables are shown with double curly braces {{ variable }}.

2. Step 2: Match the correct option

   Only {{ age }} correctly shows the variable value.

3. Final Answer:

   {{ age }} -> Option A

4. Quick Check:

   Variable display = {{ age }} [OK]

Hint: Remember: {{ variable }} shows variable value in Flask templates [OK]

Common Mistakes:

• Confusing {% %} for variables instead of control blocks
• Using syntax from other template engines like <%= %>
• Using brackets [[ ]] which Flask does not recognize

3. Given this Flask template snippet:

Hello, {{ user }}!

And the Flask code:

return render_template('template.html', user='Alice')

What will be the rendered output?

medium

A. Hello, {{ user }}!

B. Hello, user!

C. Hello, Alice!

D. Hello, !

Solution

1. Step 1: Understand variable substitution in template

   The template uses {{ user }} which will be replaced by the value passed from Flask code.

2. Step 2: Check the passed variable value

   The Flask code passes user='Alice', so {{ user }} becomes 'Alice'.

3. Final Answer:

   Hello, Alice! -> Option C

4. Quick Check:

   Variable user = Alice [OK]

Hint: Variables in {{ }} show passed values, not literal text [OK]

Common Mistakes:

• Thinking {{ user }} prints literally
• Ignoring the passed variable value
• Confusing variable name with string

4. Identify the error in this Flask template snippet:

Hello, {% user %}!

What will happen when rendering this template?

medium

A. TemplateSyntaxError due to wrong tag usage

B. SyntaxError: invalid syntax

C. It will display the literal text '{% user %}'

D. It will display the value of user variable

Solution

1. Step 1: Understand {% %} usage in Flask templates

   The {% %} syntax is for control statements like loops or conditions, not for variable substitution.

2. Step 2: Identify the error type

   Using {% user %} is invalid and causes a TemplateSyntaxError because 'user' is not a valid control tag.

3. Final Answer:

   TemplateSyntaxError due to wrong tag usage -> Option A

4. Quick Check:

   Wrong tag usage = TemplateSyntaxError [OK]

Hint: Use {{ }} for variables, {% %} only for control blocks [OK]

Common Mistakes:

• Using {% %} for variables instead of {{ }}
• Expecting literal output from {% %} tags
• Ignoring template error messages

5. You want to display a user's full name in a Flask template using two variables: first_name and last_name. Which template code correctly combines them with a space?

hard

A. {{ first_name }} + ' ' + {{ last_name }}

B. {{ first_name, ' ', last_name }}

C. {{ first_name & ' ' & last_name }}

D. {{ first_name ~ ' ' ~ last_name }}

Solution

1. Step 1: Recall string concatenation in Jinja2 templates

   Jinja2 uses the tilde (~) operator to join strings inside {{ }}.

2. Step 2: Evaluate each option

   {{ first_name ~ ' ' ~ last_name }} uses ~ correctly to join first_name, a space, and last_name. {{ first_name }} + ' ' + {{ last_name }} treats + as literal text. {{ first_name, ' ', last_name }} creates a tuple with comma. {{ first_name & ' ' & last_name }} uses invalid & operator.

3. Final Answer:

   {{ first_name ~ ' ' ~ last_name }} -> Option D

4. Quick Check:

   String join in Jinja2 = ~ operator [OK]

Hint: Use ~ to join strings in Flask (Jinja2) templates [OK]

Common Mistakes:

• Placing + outside {{ }} so it prints literally
• Using invalid operators like & or commas
• Trying Python code directly in templates