Edit on GitHub
Jump to docs navigation

Twig Components / Available variables in Twig

Note: You are currently reading the documentation for Bolt 4.0. Looking for the documentation for Bolt 5.2 instead?

To see all variables defined in the current page, use

# To output all variables in place in the HTML output
{{ dump() }}

# To output all variables in the Symfony toolbar
{% dump() %}

App

App is an instance of Symfony\Bridge\Twig\Appvariable. It contains:

Name Description
debug Boolean indicating whether Debug is enabled or not
environment Indicating the current environment, like dev or prod
request Instance of Symfony\Component\HttpFoundation\Request
session Instance of Symfony\Component\HttpFoundation\Session\Session
flashes Array of Session Flashes
user Instance of Bolt\Entity\User
tokenStorage Instance of Symfony's UsageTrackingTokenStorage
requestStack Instance of Symfony\Component\HttpFoundation\RequestStack
{{ app.debug }}

Request

The app variable also includes information about the request, accessible by:

{{ dump(app.request) }}
{% set request = app.request %}
{% set method = request.method %}
{% set host = request.headers.host %}

Session

The session can be accessed through the app variable:

{% set session = app.session %}

User

Apart from the global user variable, the user can also be accessed using the app variable:

{% set user = app.user %}
{{ user.displayName }} # shows the logged in user's display name
{{ user.username }}
{{ user.email }}
{{ user.lastSeenAt }}
{{ user.locale }}
{{ user.disabled }} # true if user is disabled, otherwise false.
{{ user.roles }} # returns an array containing the user's roles

Environment

The current environment, as set in your .env file, can be accessed:

{% environment = app.environment %} # in dev, it returns 'dev'. For production, it will return 'prod'

For more info on app, check the Symfony app variable.

Flashes

Symfony's flashes can be accessed through the global app variable:

{% for message in app.flashes('notice') %}
    <div class="flash-notice">
        {{ message }}
    </div>
{% endfor %}

Config

The config global variable is used to access the configuration available in your config.yaml and contenttypes.yaml files. It has a bunch of useful methods

get(path)

Returns a config value using a path

{% set sitename = config.get('general/sitename') %}
{% set accepted_file_types = config.get('general/accept_file_types') %}

has(path)

Returns true if config matches path, and false otherwise.

{% set has_sitename = config.get('general/sitename') %} # returns true
{% set has_fakedummy = config.get('fake/dummy) %} # returns false

contentType(contenttype)

Returns the configuration for the given contenttype.

{% set homepage_config = config.contentType('homepage') %}

Theme

The global theme variable contains the configuration for your current theme, as defined in theme.yaml. For example, if you have configured your theme with a dark/light modes, here is how to access them:

{% set mode = theme.get('mode') %}

Note: Unlike the global config, the global theme variable is a multi-dimensional array. Thus, to access nested configurations, use theme.get('level-1').get('level-2').

Record

Most pages will have a global 'record' defined that corresponds to the current page. For more information on this, see Record and Records




Edit this page on GitHub
Couldn't find what you were looking for? We are happy to help you in the forum, on Slack or on Github.