#97671File versioning in query string
Description
File versioning in query string
If configured, automatically add a query string parameter to files URI in HTML. The string could be an MD5 hash generated from file content.
Example: https://domain.ext/fileadmin/logo.svg?4857383
Purpose of this feature
TLDR: improve SEO and browser’s cache control.
It’s good practice to serve resources that don’t change often with a far-future expiration date.Examples:
- ExpiresByType text/css “access plus 1 year”
- ExpiresByType text/javascript “access plus 1 year”
- ExpiresByType image/jpeg “access plus 1 month”
- ExpiresByType image/svg+xml “access plus 1 month”
- ExpiresByType image/webp “access plus 1 month”
- ExpiresByType font/woff2 “access plus 1 month”
If these resources change and we want that visitors’ browsers get the new version, we have to manually change the file name.
TYPO3 processed files will automatically use a filename based on the file hash and configuration.
This current feature solves the browser cache problem but doesn’t work for static files or files that are not processed like SVG.
Also, about SEO, if a search engine indexes a processed image like logo_86ebcdde02.jpg and this image changes, this old image’s URI becomes 404. Instead, if the image is indexes with a URI like logo.jpg?123456, the old image URI is still 200.
References
https://simonhearne.com/2022/caching-header-best-practices/
https://web.dev/http-cache/
https://developer.mozilla.org/en-US/docs/Learn/Server-side/Apache_Configuration_htaccess#cache_expiration
Reviews 1
History 785
Show 560 earlier messages
-
Christian Toffolo changed category <span data-processor="relativetime" data-value="2022-05-22T07:51:34+00:00" > 05/22/22, 07:51 </span>
-
Benni Mack changed Sprint Focus On Location Sprint <span data-processor="relativetime" data-value="2022-08-05T09:27:02+00:00" > 08/05/22, 09:27 </span>
-
Oliver Hader changed Sprint Focus
On Location Sprint<span data-processor="relativetime" data-value="2022-11-03T09:04:24+00:00" > 11/03/22, 09:04 </span> -
Riccardo De Contardi commented <span data-processor="relativetime" data-value="2024-08-08T10:31:31+00:00" > 08/08/24, 10:31 </span>
Version 13 (I guess since 13.2) implements the cachebusting also for EXT resources; for example
TypoScript:
page.8 = TEXT page.8 { value = {asset:EXT:core/Resources/Public/Icons/Extension.svg} value.insertData=1 }and Fluid:
<f:uri.resource path="EXT:core/Resources/Public/Icons/Extension.svg" useCacheBusting="true"/>
both render something like:
/typo3/sysext/core/Resources/Public/Icons/Extension.svg?1718398160
-
Gerrit Code Review pushed patch set 7 for main to change 90675 status
NewUnder Review <span data-processor="relativetime" data-value="2025-10-01T20:40:12+00:00" > 10/01/25, 20:40 </span> -
Gerrit Code Review pushed patch set 8 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-02T08:03:43+00:00" > 10/02/25, 08:03 </span>
-
Gerrit Code Review pushed patch set 9 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-02T08:04:13+00:00" > 10/02/25, 08:04 </span>
-
Gerrit Code Review pushed patch set 10 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-02T09:17:49+00:00" > 10/02/25, 09:17 </span>
-
Gerrit Code Review pushed patch set 11 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-02T09:46:35+00:00" > 10/02/25, 09:46 </span>
-
Gerrit Code Review pushed patch set 12 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-02T11:00:20+00:00" > 10/02/25, 11:00 </span>
-
Gerrit Code Review pushed patch set 13 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-02T11:45:44+00:00" > 10/02/25, 11:45 </span>
-
Gerrit Code Review pushed patch set 14 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-02T13:11:40+00:00" > 10/02/25, 13:11 </span>
-
Gerrit Code Review pushed patch set 15 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-07T19:26:38+00:00" > 10/07/25, 19:26 </span>
-
Gerrit Code Review pushed patch set 16 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-07T21:01:37+00:00" > 10/07/25, 21:01 </span>
-
Gerrit Code Review pushed patch set 17 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-08T08:27:25+00:00" > 10/08/25, 08:27 </span>
-
Gerrit Code Review pushed patch set 18 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-08T10:41:43+00:00" > 10/08/25, 10:41 </span>
-
Gerrit Code Review pushed patch set 19 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-12T19:52:47+00:00" > 10/12/25, 19:52 </span>
-
Gerrit Code Review pushed patch set 20 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-12T21:39:32+00:00" > 10/12/25, 21:39 </span>
-
Gerrit Code Review pushed patch set 21 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-12T22:02:15+00:00" > 10/12/25, 22:02 </span>
-
Gerrit Code Review pushed patch set 22 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-12T22:33:25+00:00" > 10/12/25, 22:33 </span>
-
Gerrit Code Review pushed patch set 23 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-12T22:36:10+00:00" > 10/12/25, 22:36 </span>
-
Gerrit Code Review pushed patch set 24 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-14T13:04:06+00:00" > 10/14/25, 13:04 </span>
-
Gerrit Code Review pushed patch set 25 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-14T15:41:07+00:00" > 10/14/25, 15:41 </span>
-
Gerrit Code Review pushed patch set 26 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-14T15:54:21+00:00" > 10/14/25, 15:54 </span>
-
Gerrit Code Review pushed patch set 27 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-14T18:35:00+00:00" > 10/14/25, 18:35 </span>
-
Gerrit Code Review pushed patch set 28 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-14T19:12:04+00:00" > 10/14/25, 19:12 </span>
-
Gerrit Code Review pushed patch set 29 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-14T20:23:53+00:00" > 10/14/25, 20:23 </span>
-
Gerrit Code Review pushed patch set 30 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-14T20:33:04+00:00" > 10/14/25, 20:33 </span>
-
Gerrit Code Review pushed patch set 31 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-14T20:42:13+00:00" > 10/14/25, 20:42 </span>
-
Gerrit Code Review pushed patch set 32 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-15T07:56:28+00:00" > 10/15/25, 07:56 </span>
-
Gerrit Code Review pushed patch set 33 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-15T13:13:16+00:00" > 10/15/25, 13:13 </span>
-
Gerrit Code Review pushed patch set 34 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-15T19:46:55+00:00" > 10/15/25, 19:46 </span>
-
Gerrit Code Review pushed patch set 35 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-16T12:51:47+00:00" > 10/16/25, 12:51 </span>
-
Gerrit Code Review pushed patch set 36 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-16T15:49:15+00:00" > 10/16/25, 15:49 </span>
-
Gerrit Code Review pushed patch set 37 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-19T18:35:16+00:00" > 10/19/25, 18:35 </span>
-
Gerrit Code Review pushed patch set 38 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-19T18:50:55+00:00" > 10/19/25, 18:50 </span>
-
Gerrit Code Review pushed patch set 39 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-19T19:31:53+00:00" > 10/19/25, 19:31 </span>
-
Gerrit Code Review pushed patch set 40 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-19T20:23:09+00:00" > 10/19/25, 20:23 </span>
-
Gerrit Code Review pushed patch set 41 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-19T20:58:05+00:00" > 10/19/25, 20:58 </span>
-
Gerrit Code Review pushed patch set 42 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-19T21:35:30+00:00" > 10/19/25, 21:35 </span>
-
Gerrit Code Review pushed patch set 43 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-19T21:40:25+00:00" > 10/19/25, 21:40 </span>
-
Gerrit Code Review pushed patch set 44 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-19T21:44:53+00:00" > 10/19/25, 21:44 </span>
-
Gerrit Code Review pushed patch set 45 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T08:09:15+00:00" > 10/20/25, 08:09 </span>
-
Gerrit Code Review pushed patch set 46 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T09:05:34+00:00" > 10/20/25, 09:05 </span>
-
Gerrit Code Review pushed patch set 47 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T10:14:02+00:00" > 10/20/25, 10:14 </span>
-
Gerrit Code Review pushed patch set 48 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T11:32:57+00:00" > 10/20/25, 11:32 </span>
-
Gerrit Code Review pushed patch set 49 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T12:45:19+00:00" > 10/20/25, 12:45 </span>
-
Gerrit Code Review pushed patch set 50 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T13:44:53+00:00" > 10/20/25, 13:44 </span>
-
Gerrit Code Review pushed patch set 51 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T14:35:40+00:00" > 10/20/25, 14:35 </span>
-
Gerrit Code Review pushed patch set 52 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T14:35:56+00:00" > 10/20/25, 14:35 </span>
-
Gerrit Code Review pushed patch set 53 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T14:38:06+00:00" > 10/20/25, 14:38 </span>
-
Gerrit Code Review pushed patch set 54 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T15:59:38+00:00" > 10/20/25, 15:59 </span>
-
Gerrit Code Review pushed patch set 55 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-20T16:01:48+00:00" > 10/20/25, 16:01 </span>
-
Gerrit Code Review pushed patch set 56 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-21T06:10:59+00:00" > 10/21/25, 06:10 </span>
-
Gerrit Code Review pushed patch set 57 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-21T06:42:05+00:00" > 10/21/25, 06:42 </span>
-
Gerrit Code Review pushed patch set 58 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-21T07:14:22+00:00" > 10/21/25, 07:14 </span>
-
Gerrit Code Review pushed patch set 59 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-21T07:32:58+00:00" > 10/21/25, 07:32 </span>
-
Gerrit Code Review pushed patch set 60 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-21T07:51:14+00:00" > 10/21/25, 07:51 </span>
-
Gerrit Code Review pushed patch set 61 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-21T08:22:53+00:00" > 10/21/25, 08:22 </span>
-
Gerrit Code Review pushed patch set 62 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-21T10:21:54+00:00" > 10/21/25, 10:21 </span>
-
Gerrit Code Review pushed patch set 63 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-21T11:09:31+00:00" > 10/21/25, 11:09 </span>
-
Gerrit Code Review pushed patch set 64 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-21T18:37:34+00:00" > 10/21/25, 18:37 </span>
-
Gerrit Code Review pushed patch set 65 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-22T10:02:20+00:00" > 10/22/25, 10:02 </span>
-
Gerrit Code Review pushed patch set 66 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-22T10:02:32+00:00" > 10/22/25, 10:02 </span>
-
Gerrit Code Review pushed patch set 67 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-22T11:02:00+00:00" > 10/22/25, 11:02 </span>
-
Gerrit Code Review pushed patch set 68 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-22T18:36:12+00:00" > 10/22/25, 18:36 </span>
-
Gerrit Code Review pushed patch set 69 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-22T19:41:56+00:00" > 10/22/25, 19:41 </span>
-
Gerrit Code Review pushed patch set 70 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-23T06:19:27+00:00" > 10/23/25, 06:19 </span>
-
Gerrit Code Review pushed patch set 71 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-23T11:08:15+00:00" > 10/23/25, 11:08 </span>
-
Gerrit Code Review pushed patch set 72 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-23T12:08:31+00:00" > 10/23/25, 12:08 </span>
-
Gerrit Code Review pushed patch set 73 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-23T12:15:55+00:00" > 10/23/25, 12:15 </span>
-
Gerrit Code Review pushed patch set 74 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-23T12:23:13+00:00" > 10/23/25, 12:23 </span>
-
Gerrit Code Review pushed patch set 75 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-23T12:24:58+00:00" > 10/23/25, 12:24 </span>
-
Gerrit Code Review pushed patch set 76 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-23T12:31:12+00:00" > 10/23/25, 12:31 </span>
-
Gerrit Code Review pushed patch set 77 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-23T12:41:20+00:00" > 10/23/25, 12:41 </span>
-
Gerrit Code Review pushed patch set 78 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-23T12:54:57+00:00" > 10/23/25, 12:54 </span>
-
Gerrit Code Review pushed patch set 79 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-24T18:37:24+00:00" > 10/24/25, 18:37 </span>
-
Gerrit Code Review pushed patch set 80 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-25T10:03:49+00:00" > 10/25/25, 10:03 </span>
-
Gerrit Code Review pushed patch set 81 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-25T10:05:19+00:00" > 10/25/25, 10:05 </span>
-
Gerrit Code Review pushed patch set 82 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-25T10:08:18+00:00" > 10/25/25, 10:08 </span>
-
Gerrit Code Review pushed patch set 83 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-25T10:25:20+00:00" > 10/25/25, 10:25 </span>
-
Gerrit Code Review pushed patch set 84 for main to change 90675 <span data-processor="relativetime" data-value="2025-10-25T10:53:23+00:00" > 10/25/25, 10:53 </span>
-
Helmut Hummel commented and changed status
Under ReviewResolved done0 %100 % <span data-processor="relativetime" data-value="2025-10-25T19:35:10+00:00" > 10/25/25, 19:35 </span>Applied in changeset commit:5d637429cff45078d813436dd289aab6dd24a91b.
-
Benni Mack changed status
ResolvedClosed <span data-processor="relativetime" data-value="2025-12-02T14:33:55+00:00" > 12/02/25, 14:33 </span>
I think you mix up the two topics “SEO” and “Caching”.
Case 1 (browser caching with scaled images):
For browser caching the hashed filename is enough (
logo_86ebcdde02.jpg). If the file changes the hash also changes (as I understand) and a browser will pick up the new file. If the file with the old hash is not available anymore the browser receives a 404 – which is correct as the image changed and the old one is not available anymore. This should be no issue for the website, as after clearing the frontend cache the old images shouldn’t referenced anymore.Case 2 (browser caching with original image embedded into site):
If the image is embedded into the website with its original dimensions (and hence the original filename is used without a cache buster), I agree, this could be an issue for browser caching when using long-living cache headers, but not for SEO. For SEO this is ideal, as the content changed but not the file name.
Case 3 (SEO crawling/indexing):
For search engines a filename with a hash (
logo_86ebcdde02.jpgandlogo_abcdef12345.jpg) in the name is a different URL. But that’s also true when you have the file with a query string likelogo.jpg?1234andlogo.jpg?9876. For a search engine they are two files under different URLs (but with same content then) – I assume they recognise the duplicate content and deduplicate it in their index. This is getting worse when you change often the file. But I am not so much into image SEO and how duplicate content is in issue there – and as a canonical URL for the main URL is not available as I assume by default (it can be added though to the HTTP header, but this would be then another story).But the same content is also true for different sizes of the same image. They only differ in the size, not in the content of the image (content is the way what is seen on the image).
Would it be a way to redirect (301/307) to the new “hashed” image files like HTML URLs when someone cares much about image SEO? This is a clean way without cluttering the search index with the same image over and over again. I assume this may be possible with a custom PSR-14 event which generates automatically the redirects (some of https://docs.typo3.org/m/typo3/reference-coreapi/11.5/en-us/Events/Events/Core/Resource/Index.html may be appropriate).