Automatic Versioning of JS and CSS files for Magento.

Installs: 9 911

Dependents: 0

Suggesters: 0

Security: 0

Stars: 42

Watchers: 45

Forks: 39

Open Issues: 2


0.9.2 2018-05-01 09:36 UTC


Build Status

Author: Fabrizio Branca


This module adds the last-modified timestamp to your JS and CSS merged files to enabled browser-based caching and speed up your server.


Add following lines to your .htaccess file if storage is set to "database" and you are using apache as your web server.

Get merged js and css files from database using get.php if they do not exist in filesystem

RewriteCond %{REQUEST_URI} ^/media/css/.*\.css$ [OR]
RewriteCond %{REQUEST_URI} ^/media/js/.*\.js$

never rewrite for existing files

RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule .* ../get.php [L]

Add versions to files

If you enable one of the following in the configuration make sure to add this to your .htaccess file:

  • Add version to assets (gif|png|jpg)
  • Add version to assets (css) NOTE: only works with skin_css (not js_css)
  • Add version to assets (js) NOTE: only works with skin_js (not js - coming from /js)
RewriteRule (.*)\.(\d{10})\.(gif|png|jpg)$ $1.$3 [L,NC]
RewriteRule (.*)\.(\d{10})\.(css)$ $1.$3 [L,NC]
RewriteRule (.*)\.(\d{10})\.(js)$ $1.$3 [L,NC]

If you use NGINX, add the following lines to your nginx config within the server block for your site if you use database as the file storage location:

location ^~ /media/js/ {
    try_files $uri $uri/ @handlerjs;

location ^~ /media/css/ {
    try_files $uri $uri/ @handlercss;

location @handlerjs {
    rewrite /media/js/ /get.php;

location @handlercss {
    rewrite /media/css/ /get.php;

If you enable the Add timestamps to asset files feature, also add these lines to your nginx config file

they should NOT be added to any particular location block.

rewrite "^/(.*)\.(\d{10})\.(gif|png|jpg)$" /$1.$3 last;

Release notes


  • Use adding sequence for sorting items without given prio


  • Added system configuration setting to take store id's into account when generating the filename hash
  • Added configuration to sort assets by priorities:
<action method="addItem">


  • added unit tests
  • removed JSMin since it wasn't used
  • getSkinUrl now also optionally adds the version key to image assets


  • Allowing to add timestamps to js and css files too now. Feature "inspired" by Tymek's commit.