--- title: "How to Limit WordPress Search by a Taxonomy Term?" url: https://nexterwp.com/docs/limit-wordpress-search-by-a-taxonomy-term/ date: 2024-12-02 modified: 2026-09-27 lang: en author: "Aditya Sharma" description: "A category dropdown lets the visitor choose. Sometimes you want to make the choice for them — a search bar inside a documentation section that never returns marketing pages, or..." image: https://nexterwp.com/wp-content/uploads/2024/12/How-to-Limit-WordPress-Search-by-a-Taxonomy-Term_-1024x519.jpg word_count: 505 --- # How to Limit WordPress Search by a Taxonomy Term? ## Key Takeaways - Nexter Blocks Search Bar limita la búsqueda de WordPress por un término de taxonomía con las opciones include y exclude, y en una prueba de 14 entradas devuelve 2 resultados al incluir un término y 12 al excluirlo. - Nexter Blocks Search Bar funciona en la edición Free sin Nexter Blocks Pro activado, y el bloque se activa desde Nexter > Blocks en el panel de WordPress. - Nexter Blocks Search Bar usa términos almacenados por ID, incluye los términos hijos por diseño y solo busca el título por defecto, con una prueba que muestra 4 entradas por título frente a 15 cuando se desactivan los campos de búsqueda. A category dropdown lets the visitor choose. Sometimes you want to make the choice for them — a search bar inside a documentation section that never returns marketing pages, or a store search that skips discontinued lines. The include and exclude settings fix the scope of the search before anyone types anything. *For every Search Bar setting in one place, see the [Search Bar guide](https://nexterwp.com/docs/add-a-search-bar-in-wordpress/).* [LIVE BLOCK LINK](https://nexterwp.com/nexter-blocks/builder/wordpress-ajax-search-bar/) ## Before You Start - **Edition:** Free. Measured with Nexter Blocks Pro deactivated, the Search Bar renders identically — form, input, dropdowns, suggestions and results all work without Pro.- **Block to enable:** Search Bar, switched on under **Nexter > Blocks** in your WordPress dashboard.- **A taxonomy with terms in use.** You choose the taxonomy first, then the terms to include or exclude from it. ## Steps - Select your **Search Bar** block, choose the **taxonomy** to limit by, then add terms to **include** or **exclude** and publish. ![Include and exclude term settings](https://nexterwp.com/wp-content/uploads/2026/09/sb-query-limitterm.webp) ## How It Behaves Include and exclude are exact complements. Measured on a site of 14 posts against one category term: including it returned 2, excluding it returned 12. - **Include restricts the search to those terms.** Nothing outside them can be returned, whatever the visitor types.- **Exclude removes those terms from the search.** Everything else remains searchable.- **Child terms are included.** Both conditions are applied with children counted, so including a parent category covers its sub-categories.- **It is invisible to the visitor.** There is no dropdown and no indication that the search has been narrowed, which is the intent but also worth knowing.- **Both settings need a taxonomy chosen.** Measured: terms with no taxonomy selected are ignored entirely.- **Only the title is searched by default.** Measured: with the default settings a term matched 4 posts by title; switching the search fields off entirely fell through to WordPress's own query and matched 15. ## Limitations - **One taxonomy at a time.** You cannot include by category and exclude by tag on the same bar.- **Terms are stored by ID.** Deleting and recreating a term breaks the setting silently, because the new term has a different ID.- **The visitor gets no explanation.** If someone searches for something you have excluded, they see an empty result and no reason for it. A clear no-results message helps.- **It does not replace a filter dropdown.** Use include and exclude to set a fixed scope, and a filter field when the visitor should choose. ## Troubleshooting ### The terms I entered have no effect A taxonomy has to be selected as well. With terms set but no taxonomy chosen, both lists are ignored. ### The search stopped returning anything after I edited my categories Terms are stored by ID. If a term was deleted and recreated, re-select it here. ### Results from a sub-category are appearing even though I only included the parent That is correct. Child terms are included by design. ### I want the visitor to choose instead Use a taxonomy filter field, which renders a dropdown. See the [category search doc](https://nexterwp.com/docs/search-by-post-category-in-wordpress/). ## Related Docs - [Search by post category](https://nexterwp.com/docs/search-by-post-category-in-wordpress/)- [Search by post tag](https://nexterwp.com/docs/search-by-post-tag-in-wordpress/)- [Search custom post types by custom taxonomy](https://nexterwp.com/docs/search-custom-post-types-by-custom-taxonomy-in-wordpress/)- [Add a search bar in WordPress](https://nexterwp.com/docs/add-a-search-bar-in-wordpress/)- [Search WooCommerce products by category](https://nexterwp.com/docs/search-woocommerce-products-by-category-in-wordpress/) ## Frequently Asked Questions **Q: Why do my taxonomy terms have no effect when I limit WordPress search?** A: A taxonomy has to be selected as well, because terms set without a taxonomy are ignored entirely. That matters when you are trying to narrow search scope before the visitor types anything, since the include and exclude lists only work after the taxonomy is chosen. In Nexter Blocks, this is part of the Search Bar block behavior, so a missing taxonomy usually explains why the search still feels unrestricted. **Q: What do I need before I can limit search by a taxonomy term?** A: You need the Search Bar block enabled under Nexter > Blocks, and you need a taxonomy with terms already in use. The setup is built around choosing the taxonomy first, then deciding which terms to include or exclude. Nexter Blocks Pro can be deactivated and the Search Bar still renders identically, so this works in Free edition too. **Q: Should I include or exclude terms when I want a fixed search scope?** A: Include is the better choice when you want search locked to a specific set of terms, because nothing outside those terms can be returned. Exclude is better when you want everything searchable except a few terms. On a site with 14 posts against one category term, including it returned 2 posts while excluding it returned 12, which shows how sharply those two modes change scope. **Q: Do child categories count when I limit search to a parent category?** A: Child terms are included by design, so selecting a parent category also covers its sub-categories. That is useful when you want broader coverage without listing every child term one by one. If sub-category results appear even though only the parent was included, that is expected behavior in Nexter Blocks and not a setup error. **Q: Why did my search stop returning anything after I edited categories?** A: Terms are stored by ID, so deleting and recreating a term breaks the setting silently because the new term gets a different ID. Re-selecting the term fixes that mismatch. This is one of the main gotchas with taxonomy-based search scope in Nexter Blocks, especially after category cleanup or migration work. **Q: How do I let visitors choose a category instead of fixing the search scope?** A: Use a taxonomy filter field, which renders a dropdown. That is the right pattern when the visitor should decide what to search instead of being limited behind the scenes. The fixed include and exclude settings are for narrowing scope in advance, while the dropdown approach is covered in the [category search doc](https://nexterwp.com/docs/search-by-post-category-in-wordpress/).