possibility to reduce dimensions of scaled images #4633

New Issue

OVERLORD · 2026-02-05T09:08:46+03:00

OVERLORD commented

2026-02-05 09:08:46 +03:00

Originally created by @tipuraneo on GitHub (Apr 15, 2024).

Describe the feature you'd like

I'd like to see the possibility to define dimensions of down scaled images. 1680 pixel should be kept as default.

Describe the benefits this would bring to existing BookStack users

Properly sized images reduce bytes transferred and increase page load speed. In most cases the can cut loading time by half. Jpeg images having half dimensions have roughly one third of the size.

Currently images are 1680 pixel wide regardless of the dimensions used for presentation. Depending on the dimensions used for presentation this leads to files which are much bigger than necessary. According to website analytic tools like https://gtmetrix.com/ or https://pagespeed.web.dev/ images have a major impact on bytes transferred. Very often they recommend to probably size images to reduce loading time.

I know different users are using different themes with different maximum width. But static 1680 pixel might be unflexible and for some users to wide.

Can the goal of this request already be achieved via other means?

Since v0.26.2 BookStack re-scales images to 1680 pixel width because in some cases 840 pixels which were used till this version looked blurry in some cases. https://github.com/BookStackApp/BookStack/issues/1108

Have you searched for an existing open/closed issue?

I have searched for existing issues and none cover my fundamental request

How long have you been using BookStack?

3 months to 1 year

Additional context

No response

Originally created by @tipuraneo on GitHub (Apr 15, 2024). ### Describe the feature you'd like I'd like to see the possibility to define dimensions of down scaled images. 1680 pixel should be kept as default. ### Describe the benefits this would bring to existing BookStack users Properly sized images reduce bytes transferred and increase page load speed. In most cases the can cut loading time by half. Jpeg images having half dimensions have roughly one third of the size. Currently images are 1680 pixel wide regardless of the dimensions used for presentation. Depending on the dimensions used for presentation this leads to files which are much bigger than necessary. According to website analytic tools like https://gtmetrix.com/ or https://pagespeed.web.dev/ images have a major impact on bytes transferred. Very often they recommend to probably size images to reduce loading time. I know different users are using different themes with different maximum width. But static 1680 pixel might be unflexible and for some users to wide. ![image](https://github.com/BookStackApp/BookStack/assets/6901598/6352d43b-ee59-48ec-87e2-93dec33196c5) ![image](https://github.com/BookStackApp/BookStack/assets/6901598/437a8f84-9b7e-4d99-bd6b-a6b793cd1b6e) ### Can the goal of this request already be achieved via other means? Since v0.26.2 BookStack re-scales images to 1680 pixel width because in some cases 840 pixels which were used till this version looked blurry in some cases. https://github.com/BookStackApp/BookStack/issues/1108 ### Have you searched for an existing open/closed issue? - [X] I have searched for existing issues and none cover my fundamental request ### How long have you been using BookStack? 3 months to 1 year ### Additional context _No response_

OVERLORD added the 🔨 Feature Request label 2026-02-05 09:08:46 +03:00

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#4633