# How to use Thesaurus Search Builder

### Using Search Builder to create a search query

Follow these steps to build a targeted search query:

{% stepper %}
{% step %}

#### Identify relevant concepts by [exploring the hierarchy](https://help.cabi.org/cabi-digital-library-help/search/how-to-use-thesaurus-search-builder#explore-the-hierarchy-to-find-concepts) or [searching](https://help.cabi.org/cabi-digital-library-help/search/how-to-use-thesaurus-search-builder#search-for-a-concept) for concepts

Look for concepts related to your topic of interest (e.g. climate change and pest control)
{% endstep %}

{% step %}

#### [View more details about a concept](https://help.cabi.org/cabi-digital-library-help/search/how-to-use-thesaurus-search-builder#view-more-details-about-a-concept-1)

Check whether this is the concept you are looking for
{% endstep %}

{% step %}

#### [Build a search in My Concepts](https://help.cabi.org/cabi-digital-library-help/search/how-to-use-thesaurus-search-builder#build-a-search-in-my-concepts-1)

Add multiple concepts to build a search query
{% endstep %}

{% step %}

#### [Run your search on CABI Digital Library](#add-an-additional-concept-and-start-a-search-on-cabi-digital-library)

You will find all results that have been indexed with your selected concepts
{% endstep %}
{% endstepper %}

To help you navigate the Search Builder, here is a short description of the screen. There are three basic components in the display:

1. Hierarchy (left)
2. Graph (right)
3. My concepts (top right)

<figure><img src="/files/IRRfAVMixePxhydNJjM0" alt="Screenshot of the Search Builder, with the hierarchy indicated on the left, the graph on the right, and My Concepts in the top right corner"><figcaption></figcaption></figure>

#### Explore the hierarchy to find concepts

Let's say we're broadly interested in research related to the climate. In the video below, we show how to explore the hierarchy to find concepts:

1. Expand the hierarchy of the top level grouping *Climate Related,* which displays the graph view on the right
2. The hierarchy (on the left) and graph view (on the right) display preferred terms—those we apply to records as tags
3. Selecting a concept in the graph view displays more information, including any synonyms (under the heading altLabel)
4. *climate change* has the synonym / non-preferred term / altLabel *climatic change*

{% embed url="<https://www.cabidigitallibrary.org/cms/asset/4dd7e13f-6f5a-4b79-abc0-44489aace26d/media/a_cabt_relaunch_browse_hierarchy.mp4>" %}

#### Search for a concept

You can also use the search to find a concept:

1. Type *climatic change* in the search bar
2. Selecting the result moves you to the concept

{% embed url="<https://www.cabidigitallibrary.org/cms/asset/0ab783a5-3579-4082-a261-3611ad879f42/media/b_cabt_relaunch_search_for_concept.mp4>" %}

#### View more details about a concept

Whether we navigated to a concept through the hierarchy or jumped to it through search, we can view more information about it and any of its connected concepts:

1. Select a concept in the graph view
2. A new window opens with more details about the concept. Depending on the concept, it can show:&#x20;
   1. CABI's identifier for the concept
   2. Preferred Label
   3. Alternative Label
   4. Translations
   5. Related concepts (click to explore them)
   6. Narrower concepts (click to explore them)
   7. Terms it's frequently indexed with
   8. Broader concepts (click to explore them)
   9. Scheme it's in
   10. Exact matches with other controlled vocabularies
   11. Type of concept
   12. Indexing class: Descriptor (DE), Organism Descriptor (OD), Geographic Location (GL), Broad Term (UP), Identifier (ID), [more information](/cabi-digital-library-help/search/cabis-controlled-vocabulary-and-cabi-thesaurus.md)

&#x20;

{% embed url="<https://www.cabidigitallibrary.org/cms/asset/5ddf2e63-f69a-4388-9879-2f7e5fbb826e/media/c_cabt_relaunch_view_and_my_concepts.mp4>" %}

#### Build a search in My Concepts

'My Concepts' is where we build our search:&#x20;

1. Open My Concepts in the top right
2. In this example, we have just *climate change* stored. Let's say we want to find research to do with the impact of climate change on pest control.&#x20;
3. Go back to the search box and start typing a search for *pest control*
4. Open the matching result in the graph view
5. Add it to 'My Concepts' by clicking the + sign next to it
6. You can remove concepts from either within 'My Concepts' or in the graph view

&#x20;

{% embed url="<https://www.cabidigitallibrary.org/cms/asset/73f31e0c-42fe-451a-8bc9-9651730de257/media/d_cabt_relaunch_add_more_to_my_concepts.mp4>" %}

#### Add an additional concept and start a search on CABI Digital Library

Now we want to narrow our search by location:&#x20;

1. Move to the top level grouping Geographical Entities
2. Drill down to for example Africa
3. Add that to 'My Concepts'
4. The search string updates to show that all the terms are connected with AND - requiring all the tags to be present on the returned records
5. From 'My Concepts' we launch our search on CABI Digital Library by clicking 'Run Search Query'
6. CABI Digital Library returns all records tagged with *climate change, pest control* and *Africa*

{% hint style="info" %}
You can make a search more complex using other Boolean operators (OR, NOT).
{% endhint %}

{% embed url="<https://www.cabidigitallibrary.org/cms/asset/4fd4d521-d3b0-4eba-b50f-aa3f9c997694/media/e_cabt_relaunch_launch_search.mp4>" %}

### How CABI Thesaurus powers Search Builder and helps to retrieve records on CABI Digital Library

At the end of each database record on CABI Digital Library, you see its Indexing Terms.

<figure><img src="https://www.cabidigitallibrary.org/cms/asset/3032b73f-380b-4f95-9d44-958dc14747b1/media/cabt_relaunch_record_with_tags.png" alt="Screenshot of Indexing Terms shown below an abstract record on CABI Digital Library"><figcaption></figcaption></figure>

These 'tags' are applied by our indexers before loading to CABI Digital Library. We host records from diverse sources, and by tagging records using our own controlled vocabulary, we describe the content consistently, making it easier to retrieve.

In this example, the title and abstract only mentions the common name *triticale*, but the relevant **Organism Descriptor** *Triticum x Secale* has been added from the Thesaurus. As a result, this record can be retrieved alongside other records that mention Triticum x Secale explictly. General concepts like 'arid zones' and 'cultivars'—whether referred to as such or using different terminology—are added as **Descriptors**. And **Geographical Locations** are also drawn from the Thesaurus's preferred terms, so that the where of a record is also described consistently.

This indexing is one side of the coin, but the other is to enable users to discover our indexing terms and make use of them, to build precise searches that take advantage of this consistent approach to describing our content. The CABI Thesaurus Search Builder is designed to do just that.


---

# Agent Instructions: 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://help.cabi.org/cabi-digital-library-help/search/how-to-use-thesaurus-search-builder.md?ask=<question>
```

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.