Add shelf-level toggle to show/hide book thumbnails #5293

New Issue

OVERLORD · 2026-02-05T09:54:35+03:00

OVERLORD commented

2026-02-05 09:54:35 +03:00

Originally created by @FaroJoaoFaro on GitHub (May 23, 2025).

Describe the feature you'd like

I would like an option in the shelf edit settings to toggle the visibility of book thumbnails for that specific shelf. This would allow departments or teams to choose whether book thumbnails are shown or hidden, instead of relying on custom CSS or a global setting. Ideally, this should be a simple toggle (e.g., a checkbox) when editing a shelf, to hide all book images for that shelf.

Describe the benefits this would bring to existing BookStack users

Enables different departments or teams to choose their preferred display style for book thumbnails, enhancing flexibility.
Avoids the need for custom CSS hacks or removing images globally, supporting both visual and minimalist preferences.
Makes the platform more user-friendly for organizations with varied design or documentation needs.

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

No. Currently, this can only be achieved by applying custom CSS to hide images, which affects all shelves or requires manual targeting and maintenance. A shelf-level toggle would be more accessible, maintainable, and user-friendly.

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

In my organization, my department prefers having images on our shelf books, but other departments prefer a simpler, image-free look. A per-shelf toggle would satisfy both needs and improve BookStack’s versatility.

Originally created by @FaroJoaoFaro on GitHub (May 23, 2025). ### Describe the feature you'd like I would like an option in the shelf edit settings to toggle the visibility of book thumbnails for that specific shelf. This would allow departments or teams to choose whether book thumbnails are shown or hidden, instead of relying on custom CSS or a global setting. Ideally, this should be a simple toggle (e.g., a checkbox) when editing a shelf, to hide all book images for that shelf. ### Describe the benefits this would bring to existing BookStack users - Enables different departments or teams to choose their preferred display style for book thumbnails, enhancing flexibility. - Avoids the need for custom CSS hacks or removing images globally, supporting both visual and minimalist preferences. - Makes the platform more user-friendly for organizations with varied design or documentation needs. ### Can the goal of this request already be achieved via other means? No. Currently, this can only be achieved by applying custom CSS to hide images, which affects all shelves or requires manual targeting and maintenance. A shelf-level toggle would be more accessible, maintainable, and user-friendly. ### 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 In my organization, my department prefers having images on our shelf books, but other departments prefer a simpler, image-free look. A per-shelf toggle would satisfy both needs and improve BookStack’s versatility.

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

OVERLORD closed this issue

2026-02-05 09:54:37 +03:00

OVERLORD commented

2026-02-05 09:54:39 +03:00

@ssddanbrown commented on GitHub (May 23, 2025):

Hi @FaroJoaoFaro,

Thanks for the request, but this is a level of UI specific configurability I try to avoid in the platform, and since there's been little prior demand for this I wouldn't be keen on support an implementation.

That said, this is a good use-case for tag classes. As an example, set the following "Custom HTML Head Content":

<style>
	/* Hide book thumbnails when inside a shelf tagged with a "Customization => HideThumbnails" tag*/
	.tag-pair-customization-hidethumbnails .entity-list-item-image.bg-book {
		display: none;
	}
	.tag-pair-customization-hidethumbnails .grid-card > .bg-book {
		display: none;
	}
</style>

Then, add a tag to the desired shelf with the name of Customization and the value of HideThumbnails.
The custom CSS to hide thumbnails will then enact on shelves with this tag. You can then easily apply this to other shelves via a tag in the same way.

@ssddanbrown commented on GitHub (May 23, 2025): Hi @FaroJoaoFaro, Thanks for the request, but this is a level of UI specific configurability I try to avoid in the platform, and since there's been little prior demand for this I wouldn't be keen on support an implementation. That said, this is a good use-case for [tag classes](https://www.bookstackapp.com/docs/admin/hacking-bookstack/#tag-classes). As an example, set the following "Custom HTML Head Content": ```html <style> /* Hide book thumbnails when inside a shelf tagged with a "Customization => HideThumbnails" tag*/ .tag-pair-customization-hidethumbnails .entity-list-item-image.bg-book { display: none; } .tag-pair-customization-hidethumbnails .grid-card > .bg-book { display: none; } </style> ``` Then, add a tag to the desired shelf with the name of `Customization` and the value of `HideThumbnails`. The custom CSS to hide thumbnails will then enact on shelves with this tag. You can then easily apply this to other shelves via a tag in the same way.

OVERLORD commented

2026-02-05 09:54:41 +03:00

@FaroJoaoFaro commented on GitHub (May 26, 2025):

Hello @ssddanbrown

Thank you for your answer!
Yes this is true. I wasn't aware of the tags but I was able to make them work

In my case using
.tag-name-hidebooksthumbnails

I will therefore mark this issue as closed.
Have a nice day!

@FaroJoaoFaro commented on GitHub (May 26, 2025): Hello @ssddanbrown Thank you for your answer! Yes this is true. I wasn't aware of the tags but I was able to make them work In my case using `.tag-name-hidebooksthumbnails` I will therefore mark this issue as closed. Have a nice day!

OVERLORD referenced this issue

2026-02-05 10:32:58 +03:00

[PR #5293] [MERGED] simpifly Dockerfiles #6463

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#5293