This issue has been created
There are 4 updates.
 
 
XWiki Platform / cid:jira-generated-image-avatar-2a470e5d-0b21-4652-a302-371d53e64950 XWIKI-25320 Open

Allow WebP, AVIF and JPEG XL images as user avatar and logo

 
View issue   ·   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-ad45e52b-a4f9-4046-b694-a59102e36f81 Claude created this issue on 16/Oct/26 21:43
 
Summary: Allow WebP, AVIF and JPEG XL images as user avatar and logo
Issue Type: cid:jira-generated-image-avatar-2a470e5d-0b21-4652-a302-371d53e64950 Improvement
Affects Versions: 17.10.0
Assignee: Unassigned
Components: Flamingo Theme, Skin - UI, User - User Profile
Created: 16/Oct/26 21:43
Priority: cid:jira-generated-image-static-major-c6603f6b-9ac1-4cbe-bb71-5f877c7a27f4 Major
Reporter: Claude
Description:

The attachment selectors used to choose a user avatar, a color theme logo and a skin logo only accept a hard-coded list of file extensions:

Where Page Accepted extensions
User profile avatar XWiki.XWikiUserSheet png,jpg,jpeg,gif
Color theme logo FlamingoThemesCode.ThemeSheet png,jpg,gif,svg
Skin logo SkinsCode.XWikiSkinsSheet png,jpg,gif,svg

So a WebP, AVIF or JPEG XL image cannot be used as avatar or logo, and a .jpeg image cannot be used as logo (it's accepted for avatars since XWIKI-14780).

Proposal

Add webp, avif and jxl to these three lists, and jpeg to the two logo ones.

WebP and AVIF are displayed by all the browsers supported by XWiki. JPEG XL is displayed by default by Safari 17+, Chrome 155+ and Firefox 158+, but not yet by Edge or Firefox ESR: a JPEG XL avatar or logo is not displayed for visitors using such browsers, so it's up to the user or admin choosing it. Since browser support is growing, it's better to allow it now rather than to forget about it later.

Notes

  • Server-side resizing doesn't support these formats (no Java ImageIO codec), so the original image is sent where a thumbnail is requested (e.g. small avatars).
  • Notification emails need to use the default avatar / logo for these formats, since they cannot be resized on the server and are not displayed by most mail clients (see the related issue).
 
 

4 updates

 
cid:jira-generated-image-avatar-ad45e52b-a4f9-4046-b694-a59102e36f81 Changes by Claude on 16/Oct/26 21:43
 
Description: The attachment selectors used to choose a user avatar, a color theme logo and a skin logo only accept a hard-coded list of file extensions:

||Where||Page||Accepted extensions||
|User profile avatar|{{XWiki.XWikiUserSheet}}|{{png,jpg,jpeg,gif}}|
|Color theme logo|{{FlamingoThemesCode.ThemeSheet}}|{{png,jpg,gif,svg}}|
|Skin logo|{{SkinsCode.XWikiSkinsSheet}}|{{png,jpg,gif,svg}}|

So a WebP, AVIF or JPEG XL image cannot be used as avatar or logo, and a {{.jpeg}} image cannot be used as logo (it's accepted for avatars since XWIKI-14780).

h2. Proposal

Add {{webp}}, {{avif}} and {{jxl}} to these three lists, and {{jpeg}} to the two logo ones.

WebP and AVIF are displayed by all the browsers supported by XWiki. JPEG XL is displayed by default by Safari 17+, Chrome 155+ and Firefox 158+, but not yet by Edge or Firefox ESR: a JPEG XL avatar or logo is not displayed for visitors using such browsers, so it's up to the user or admin choosing it. Since browser support is growing, it's better to allow it now rather than to forget about it later.

h2. Notes

* Server-side resizing doesn't support these formats (no Java ImageIO codec), so the original image is sent where a thumbnail is requested (e.g. small avatars).
* Notification emails need to use the default avatar / logo for these formats, since they cannot be resized on the server and are not displayed by most mail clients (see
the related issue XWIKI-25318 ).
Assignee: Claude
 
cid:jira-generated-image-avatar-948c6c56-d328-4aa2-bde3-844b68adf705 Changes by Clément Christiaens on 16/Oct/26 21:47
 
Reporter: Claude Clément Christiaens
Assignee: Claude Clément Christiaens