Feature Wiki
Tabs
Max Size for Media in the ILIAS Page Editor
Page Overview
[Hide]- 1 Summary
- 2 Problem Statement
- 3 Concept
- 4 User Interface Modifications
- 5 Non-Functional Implications
- 5.1 Security
- 5.2 Privacy
- 5.3 Accessibility Implications
- 6 Process Information
- 6.1 Involved Authorities
- 6.2 Contact
- 6.3 Funding
- 7 Discussion
- 8 Implementation
- 8.1 Description and Screenshots
- 8.2 Test Cases
- 8.3 Privacy
- 8.4 Approval
1 Summary
Media containers in the ILIAS Page Editor should offer a Maximum Size option, either in addition to or instead of Fixed Size. It would let users limit an image's displayed dimensions while preserving responsive behaviour, so the image can shrink to fit smaller screens.
2 Problem Statement
The Fixed Size option lets users adjust how large an image appears, but removes its responsiveness. Users frequently need to scale down oversized images directly through the media container's Instance Properties or Default Properties, while keeping the image responsive.
Some users cannot resize the image outside ILIAS or do not know the appropriate display dimensions in advance. They use Fixed Size to experiment, but the resulting fixed dimensions do not meet their need to preserve responsiveness. The Resize Image File option may not be understood or may be unsuitable when users want to keep the original file unchanged - for example, if the content or desired display size may change later.
3 Concept
Provide a Maximum Size option for media containers. Users can set maximum width and height while allowing the image to scale down proportionally when the available space is smaller.
The option could be offered alongside Fixed Size, preserving fixed sizing where it is intentionally needed. A short explanatory note should clarify that Maximum Size sets an upper limit and the image remains responsive. If the interface or implementation makes a separate option unnecessary, an alternative would be to change the existing sizing behaviour.
4 User Interface Modifications
4.1 List of Affected Views
- Media settings in the ILIAS Page Editor
- Instance Properties for media containers
- Default Properties for media containers
- Instance Properties for media containers
4.2 User Interface Details
Add a Maximum Size setting alongside or instead of Fixed Size.
4.3 New User Interface Concepts
This proposal introduces a new sizing option in the media container settings. It should follow the existing form controls and terminology used in the ILIAS Page Editor. The explanatory note should be available to assist users in distinguishing Maximum Size from Fixed Size.
4.4 Technical Aspects
For media, the maximum dimensions should be implemented using CSS constraints such as max-width and max-height, rather than fixed width and height values. The image should preserve its aspect ratio (checkbox) and scale down when the available space is smaller than its maximum dimensions.
Killing, Alexander [alex], 6 Nov 2026: A precondition are responsive link areas (map areas) when being used. The would need to move to an SVG overlay solution similar to the interactive images. Native HTML map areas are not responsive.
5 Non-Functional Implications
5.1 Security
None
5.2 Privacy
None
5.3 Accessibility Implications
None
6 Process Information
6.1 Involved Authorities
- Authority to Sign off on Conceptual Changes: Killing, Alexander [alex]
- Authority to Sign off Code Changes: Killing, Alexander [alex]
If this request is related to multiple components, please list both authorities for all related components.
6.2 Contact
Person to be contacted in case of questions about the feature or for funding offers: Becker, Matthias [matthias.becker]
6.3 Funding
Funding status and funding parties are listed in the block 'Status of Feature' in the right column of this page.
If you are interested to give funding for this feature, please get into contact with the person mentioned above as 'Contact'.
7 Discussion
Killing, Alexander [alex], 6 Nov 2026: I added a comment above about the necessity to have responsive link areas (map areas) for this.
Kunkel, Matthias [mkunkel], 11 NOV 2026: You mentioned above 'The Resize Image File option may not be understood'. How about adding a byline to this option and give a short explanation what the option is for?
Becker, Matthias [matthias.becker], 16 NOV 2026: @Alex, thank your for adding the necessary context and what else has to be taken into consideration considering this FR.
@Matthias, thank you for your input. I think a byline would definitely help, but not solve the issue. The need to resize images to enlarge them again later on is still a valid need and also resizing images permanently changes the size of the image and the "Show Fullscreen" option only shows the resized image.
JourFixe, ILIAS [jourfixe], 16 NOV 2026: We highly appreciate this suggestion and accept it for trunk. We agree to give up the fixed size option and only to offer a maximum size of an image. Precondition for this is the introduction of responsive link areas. Images that currently have a fixed size are migrated to max size. And for better usability, a byline that explains the resizing of an image would be nice.
8 Implementation
Feature has been implemented by {Please add related profile link of this person}
8.1 Description and Screenshots
{ Description of the final implementation and the changed behaviour in the related components. Please add screenshots to visualise the changes if possible. }
8.2 Test Cases
Test cases completed at {date} by {user}
- {Test case number linked to Testrail} : {test case title}
8.3 Privacy
Information in privacy.md of component: updated at {date} by {user} | no change required
8.4 Approval
Approved at {date} by {user}.
Last edited: Yesterday, 14:59, Kunkel, Matthias [mkunkel]

