# Search ## Overview Compendia provides two search fields that let you filter the file list by filename and by folder name. You can use either or both to narrow the list down to files that match a naming pattern, a specific name, or files located in folders with a particular name. ## Searching by Filename The filename search field filters the file list to show only files whose names contain the text you typed. The search updates in real time as you type and is not case-sensitive. For example, typing `vacation` would match any file with that word in its name, such as `vacation_day1.jpg` or `summer_vacation.heic`. ## Searching by Folder Name The folder search field works the same way but matches against the name of the folder each file is in rather than the filename itself. This is useful for finding all files that live in folders with a particular name anywhere in your folder tree, without having to navigate to each one manually. For example, typing `2023` would show files from any subfolder whose name contains `2023`. ## Using Search Alongside Tag Filters Both search fields work alongside all other active filters. If you have tag filters, a star rating filter, or a date filter active, the search fields narrow the results further within that already-filtered set. You can combine filename search, folder search, and tag filters freely to zero in on exactly the files you need. ## Searching the Tag Library The Tag Library has its own search box, separate from the file search fields. It filters the tags displayed in the Tag Library by name, making it easy to find a specific tag when your library has grown large. For example, if you have tagged a hundred people and want to find the tag for Susan, type `Susan` in the Tag Library search box. Only tags whose names contain that text will be shown. The file list is not affected. This is useful any time you need to locate, drag, or inspect a specific tag without scrolling through the full library. ## Clearing a Search To clear a search field, delete the text in it or click the clear button at the right end of the field. The file list updates immediately. You can clear each field independently. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://compendia.gitbook.io/compendia/search.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.