Ordering of CSS files for Magento2

Installs: 9 382

Dependents: 0

Suggesters: 0

Security: 0

Stars: 23

Watchers: 3

Forks: 9

Open Issues: 1


1.1.4 2019-08-07 13:07 UTC

This package is auto-updated.

Last update: 2020-11-07 16:07:13 UTC


Order assets (read: css tags) explicitly with an order attribute

Magento2 has no way to order assets out of the box. This extension allows you to specify an order attribute in css tags in layout XML files and layout updates in the admin UI.



composer require quickshiftin/assetorderer


Download the repository and add it in your Magento2 installation under app/code/Quickshiftin/Assetorderer

Magento commands

Once you've installed the code via composer or download, you need to run some Magento commands:

  • bin/magento module:enable Quickshiftin_Assetorderer
  • bin/magento setup:upgrade
  • rm -rf var/cache var/di var/generation var/page_cache && bin/magento setup:di:compile


Suppose you want to add a custom CSS file, css/home.css, on your homepage. Ordinarilly you would enter this in the layout update editor

<css src="css/home.css"/>

However, Magento most likely will place the generated link tag before the base CSS file, thus not honoring the cascade. With the extension installed you can enter the css tag with an arbitrary order attribute like so

<css src="css/home.css" order="100" />

Any tags without an explicit order will come as they appear normally (effectively treated like they have an order of 1).

Unit Tests

To run the unit tests, in a working installation of Magento2, with the extension enabled

  • cp vendor/quickshiftin/assetorderer/phpunit.xml dev/tests/unit
  • cd dev/tests/unit
  • php ../../../vendor/phpunit/phpunit/phpunit