You can use multiple different designs (themes) in your installation. You can set up different designs per SiteAccess or SiteAccess group.
Designs are configured under the
1 2 3 4
To indicate when to use a design, configure it under
1 2 3 4
Each scope can use only one design.
After you create a new folder with a design in
you must clear the cache (
php bin/console cache:clear), even if you work in the dev environment.
Order of themes¶
The order of themes in a design is important.
The design engine attempts to apply the first theme in configuration (for example,
If it cannot find the required template or asset in this theme, it proceeds to the next theme in the list (for example,
You can use this behavior to override only some templates from the main theme of your website. Do this, for example, when you create a SiteAccess with a special design for a campaign.
Additional theme paths¶
You can add any Twig template folder to the theme configuration.
You can use it if you want to define templates from third-party bundles as part of one of your themes, or to override built-in shop templates.
To do it, set the
1 2 3 4 5 6
Theme folders that you define have priority over the ones defined in
This ensures that it is always possible to override a template at the application level.
You can also add a global override folder, by listing paths without assigning them to a theme:
1 2 3
In production environments, to improve performance, asset resolution is done at compilation time. In development environments, assets are resolved at runtime.
You can change this behavior by setting
If you are using PHPStorm, and your PHPStorm project root doesn't match your Symfony project root,
you must customize the path where the design engine stores its configuration file.
Otherwise, PHPStorm does not recognize the
@ezdesign Twig namespace.
Configure it under
1 2 3