Search in selcted shelfs #2884

Open
opened 2026-02-05 05:36:20 +03:00 by OVERLORD · 9 comments
Owner

Originally created by @stothew on GitHub (Jun 30, 2022).

Describe the feature you'd like

as you can search in books we would love to see a feature to search in a shelf or tick/untick shelves on the left corner of a global search.

Describe the benefits this would bring to existing BookStack users

this way you could filter the search and reduce the number of unwanted search results on bigger libraries.

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

no

Have you searched for an existing open/closed issue?

  • I have searched for existing issues and none cover my fundemental request

How long have you been using BookStack?

1 to 5 years

Additional context

No response

Originally created by @stothew on GitHub (Jun 30, 2022). ### Describe the feature you'd like as you can search in books we would love to see a feature to search in a shelf or tick/untick shelves on the left corner of a global search. ### Describe the benefits this would bring to existing BookStack users this way you could filter the search and reduce the number of unwanted search results on bigger libraries. ### Can the goal of this request already be achieved via other means? no ### Have you searched for an existing open/closed issue? - [X] I have searched for existing issues and none cover my fundemental request ### How long have you been using BookStack? 1 to 5 years ### Additional context _No response_
OVERLORD added the 🔨 Feature Request label 2026-02-05 05:36:20 +03:00
Author
Owner

@ssddanbrown commented on GitHub (Jul 2, 2022):

Thanks for the request @stothew,

Would just the addition of a search bar to the shelf, to search within, as per the books view, cover your needs?
Providing a select/checklist for shelves within the search interface would require a lot of custom UI and handling to implement properly, which I don't think would be worth to be honest since there's been little other demand, but I could see some value in aligning book and shelf behaviour.

@ssddanbrown commented on GitHub (Jul 2, 2022): Thanks for the request @stothew, Would just the addition of a search bar to the shelf, to search within, as per the books view, cover your needs? Providing a select/checklist for shelves within the search interface would require a lot of custom UI and handling to implement properly, which I don't think would be worth to be honest since there's been little other demand, but I could see some value in aligning book and shelf behaviour.
Author
Owner

@stothew commented on GitHub (Jul 4, 2022):

Thank you for the reply.
The addition of a search bar to the shelf, to search within, would totally fulfill my needs!
And yes, in my opinion, this would also add more consistency to the UI and enhance the freedom for own Data structures.

@stothew commented on GitHub (Jul 4, 2022): Thank you for the reply. The addition of a search bar to the shelf, to search within, would totally fulfill my needs! And yes, in my opinion, this would also add more consistency to the UI and enhance the freedom for own Data structures.
Author
Owner

@helson22 commented on GitHub (Oct 5, 2022):

I also would like such a feature! I think it's a must :-)

@helson22 commented on GitHub (Oct 5, 2022): I also would like such a feature! I think it's a must :-)
Author
Owner

@vincentbernat commented on GitHub (Nov 29, 2023):

Any indication on how to implement this? I could help. I would like to be able to search in a book, but a shelf is also a good target.

@vincentbernat commented on GitHub (Nov 29, 2023): Any indication on how to implement this? I could help. I would like to be able to search in a book, but a shelf is also a good target.
Author
Owner

@stothew commented on GitHub (Nov 29, 2023):

for books, this already exists... If you select a specific/single book you get a search bar on the top left side menu to search only within this book.
Anyway, I would still love to search on shelves. So feel free to help :)

@stothew commented on GitHub (Nov 29, 2023): for books, this already exists... If you select a specific/single book you get a search bar on the top left side menu to search only within this book. Anyway, I would still love to search on shelves. So feel free to help :)
Author
Owner

@wavedeck commented on GitHub (Oct 31, 2024):

Searching on shelves is a must if you have books with a similar title to other books in other shelves. I have to fight with that issue myself.

As pointed out in multiple other Issues, that have been closed in favor of this stale one, prioritizing such feature (maybe even in the means of adding it to a "help wanted" board) would be a massive functionality and UX improvement. I totally get it, why suggested compromises like adding the shelf name to the bread crumbs of the book would not be possible, because of the theoretical possibility of the same book being in multiple shelves. I do not do this, as do probably many others, but don't break what is already a core feature and the reason why someone, somewhere in this world uses BookStack over other solutions.

In regards to @stothew :

for books, this already exists... If you select a specific/single book you get a search bar on the top left side menu to search only within this book.

While it's true, that books have a dedicated additional search bar to search within a book, i don't think this is best for UI / UX anyways. The main search at the top center of the current BookStack frontend is a lot more prevalent to a user. If this feature gets implemented, it should also be considered to redesign the main search as a single source of truth. For example by having a small dropdown within the search bar where the user can specify between "all", "book" and "shelf", depending what part of the UI the user is currently at. this could also be enhanced in the future for in-page searches by highlighting the matching text within the currently viewed page.

@wavedeck commented on GitHub (Oct 31, 2024): Searching on shelves is a must if you have books with a similar title to other books in other shelves. I have to fight with that issue myself. As pointed out in multiple other Issues, that have been closed in favor of this stale one, prioritizing such feature (maybe even in the means of adding it to a "help wanted" board) would be a massive functionality and UX improvement. I totally get it, why suggested compromises like adding the shelf name to the bread crumbs of the book would not be possible, because of the theoretical possibility of the same book being in multiple shelves. I do not do this, as do probably many others, but don't break what is already a core feature and the reason why someone, somewhere in this world uses BookStack over other solutions. In regards to @stothew : > for books, this already exists... If you select a specific/single book you get a search bar on the top left side menu to search only within this book. While it's true, that books have a dedicated additional search bar to search within a book, i don't think this is best for UI / UX anyways. The main search at the top center of the current BookStack frontend is a lot more prevalent to a user. If this feature gets implemented, it should also be considered to redesign the main search as a single source of truth. For example by having a small dropdown within the search bar where the user can specify between "all", "book" and "shelf", depending what part of the UI the user is currently at. this could also be enhanced in the future for in-page searches by highlighting the matching text within the currently viewed page.
Author
Owner

@wavedeck commented on GitHub (Oct 31, 2024):

however, to make it possible in the first place, a first step in the right direction would be to extend the search engine filters currently used in BookStack with a new option, to filter by a shelf slug (as the name of a shelf can be the same as another)

@wavedeck commented on GitHub (Oct 31, 2024): however, to make it possible in the first place, a first step in the right direction would be to extend the search engine filters currently used in BookStack with a new option, to filter by a shelf slug (as the name of a shelf can be the same as another)
Author
Owner

@mkniehl commented on GitHub (Nov 25, 2024):

We are encountering the same issue and are considering a practical and effective solution.
How about implementing a context-specific search box? When you're at the root level, the search would cover all shelves.
if you're within a specific shelf, the search would be limited to books in that particular shelf.
Additionally, the Advanced Search could be enhanced with an option to select multiple shelves?

@mkniehl commented on GitHub (Nov 25, 2024): We are encountering the same issue and are considering a practical and effective solution. How about implementing a context-specific search box? When you're at the root level, the search would cover all shelves. if you're within a specific shelf, the search would be limited to books in that particular shelf. Additionally, the Advanced Search could be enhanced with an option to select multiple shelves?
Author
Owner

@bendem commented on GitHub (May 19, 2025):

Our instance of bookstack is growing and it's getting hard to find what we are looking for. The search would really benefit from hierarchical search (search in specific shelf, book or chapter).

I don't think there is a need to search in multiple things at once, just restricting the search to a specific container would be fine.

It can be a custom syntax and/or a search button in shelves, books and chapters until there is time to develop a UI for it. Something like what github does would be enough:
Image.

@bendem commented on GitHub (May 19, 2025): Our instance of bookstack is growing and it's getting hard to find what we are looking for. The search would really benefit from hierarchical search (search in specific shelf, book or chapter). I don't think there is a need to search in multiple things at once, just restricting the search to a specific container would be fine. It can be a custom syntax and/or a search button in shelves, books and chapters until there is time to develop a UI for it. Something like what github does would be enough: ![Image](https://github.com/user-attachments/assets/1b0e4142-8128-47bd-8ba0-64dbad4ba995).
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/BookStack#2884