Using custom CSS and JavaScript in the Storefront

Quite often your plugin will have to change a few templates for the Storefront. Those might require custom styles to look neat and a few lines of JavaScript, to add special functionality. This How To will explain how this is done.


You won't learn to create a plugin in this guide, head over to our developer guide to create your plugin first. The plugin in this example will be called StorefrontAssets.

Injecting into the storefront

If you want to add static assets like images or fonts, you can place them in the public folder of your Plugin. They will be copied to the public folder of Shopware 6 when you build the storefront. Your plugin shouldn't put its assets into another directory outside of its scope though - but how do those assets from plugins actually work then?

For CSS and Javascript things are a bit different. CSS and SCSS is handled by a PHP SASS compiler.

JavaScript can't be compiled by PHP so webpack is used for compilation. This also means that you have to ship your plugin with the JavaScript already build.

If you don't want to create a custom webpack configuration, you can use the Shopware webpack build configuration. In order to do that, you have to define an entry-point, so webpack knows where to get started. In Shopware 6, this entry-point is a main.js file inside of the following directory: <plugin root>/src/Resources/app/storefront/src

Note: For administration files, the path would be same, but ending with administration/src of course.

Go ahead and create a main.js in that directory.

Adding styles

By default, Shopware looks in the <plugin root>/src/Resources/app/storefront/src/scss folder of your plugin to load a base.scss file.

To try it out, create a base.scss file in the folder mentioned above.

Inside of the .scss file, add some styles to see if it's working. In this example, the background of the body will be changed.

body {
    background: blue;

In case you want to use the same color in several places, but want to define it just one time you can use variables for this.

Create a abstract/variables.scss file inside your styles folder and define your background color variable.

// in variables.scss
$sw-storefront-assets-color-background: blue;

Inside your base.scss file you can now import your previously defined variables and use them:

// in base.scss
@import 'abstract/variables.scss';

body {
    background: $sw-storefront-assets-color-background;

This has the advantage that when you want to change the values of your variables you just have one location to change them and the hard coded values are not cluttered all over the codebase.

Loading the assets

Since Shopware knows where your style files are located, they are automatically compiled, compressed and loaded in the storefront. For JavaScript you normally would have two locations where your *.js files are located. You have your main.js as an entry point inside of the following directory: <plugin root>/src/Resources/app/storefront/src.

By default the compiled js file is saved at <plugin root>/src/Resources/app/storefront/dist/storefront/js/<plugin-name>.js. This file will be recognized automatically by shopware.

Testing its functionality

Now you want to test if your custom styles actually apply to the Storefront. For this, you have to execute the compiling and building of the .js and .css files first. This is done using the following command from inside the development template directory:

./psh.phar storefront:build

Important note: This might also generate a public directory inside your plugin. Always ship this directory with your plugin, do not exclude or remove it!

That's it! Open the Storefront and see it turning blue, due to your custom styles!


There's a GitHub repository available, containing this example source. Check it out here.

Was this article helpful?