# Class CategorySuggestions

- [TopLevel.Object](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md)
  - [dw.suggest.Suggestions](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.Suggestions.md)
    - [dw.suggest.CategorySuggestions](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.CategorySuggestions.md)

The category suggestion container provides access to
categories found using the suggested terms as search criteria.
The method [getSuggestedCategories()](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.CategorySuggestions.md#getsuggestedcategories) can be used to
get the list of found categories.

Furthermore the list of suggested terms, after processing
the original user input search query, is accessible
through [SearchPhraseSuggestions.getSuggestedTerms()](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.SearchPhraseSuggestions.md#getsuggestedterms) method.

## Property Summary

| Property                                                                                                                                         | Description                                                                                              |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
| [suggestedCategories](#suggestedcategories): [Iterator](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.Iterator.md) `(read-only)` | This method returns a list of categories which were found  using the suggested terms as search criteria. |

## Constructor Summary

This class does not have a constructor, so you cannot create it directly.

## Method Summary

| Method                                                                                                                                     | Description                                                                                              |
| ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
| [getSuggestedCategories](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.CategorySuggestions.md#getsuggestedcategories)() | This method returns a list of categories which were found  using the suggested terms as search criteria. |

### Methods inherited from class Suggestions

[getSearchPhraseSuggestions](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.Suggestions.md#getsearchphrasesuggestions), [getSuggestedPhrases](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.Suggestions.md#getsuggestedphrases), [getSuggestedTerms](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.Suggestions.md#getsuggestedterms), [hasSuggestedPhrases](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.Suggestions.md#hassuggestedphrases), [hasSuggestedTerms](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.Suggestions.md#hassuggestedterms), [hasSuggestions](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.Suggestions.md#hassuggestions)

### Methods inherited from class Object

[assign](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#assignobject-object), [create](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#createobject), [create](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#createobject-object), [defineProperties](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#definepropertiesobject-object), [defineProperty](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#definepropertyobject-object-object), [entries](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#entriesobject), [freeze](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#freezeobject), [fromEntries](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#fromentriesiterable), [getOwnPropertyDescriptor](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getownpropertydescriptorobject-object), [getOwnPropertyNames](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getownpropertynamesobject), [getOwnPropertySymbols](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getownpropertysymbolsobject), [getPrototypeOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#getprototypeofobject), [hasOwnProperty](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#hasownpropertystring), [is](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isobject-object), [isExtensible](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isextensibleobject), [isFrozen](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isfrozenobject), [isPrototypeOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#isprototypeofobject), [isSealed](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#issealedobject), [keys](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#keysobject), [preventExtensions](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#preventextensionsobject), [propertyIsEnumerable](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#propertyisenumerablestring), [seal](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#sealobject), [setPrototypeOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#setprototypeofobject-object), [toLocaleString](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#tolocalestring), [toString](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#tostring), [valueOf](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#valueof), [values](/docs/commerce/b2c-commerce/references/b2c-script-api/TopLevel.Object.md#valuesobject)

## Property Details

### suggestedCategories

- suggestedCategories: [Iterator](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.Iterator.md) `(read-only)`
  - : This method returns a list of categories which were found
    using the suggested terms as search criteria.
    The category lookup is being executed in the current catalog and locale.

    **See Also:**

    - [Suggestions.hasSuggestions()](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.Suggestions.md#hassuggestions)

***

## Method Details

### getSuggestedCategories()

- getSuggestedCategories(): [Iterator](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.util.Iterator.md)
  - : This method returns a list of categories which were found
    using the suggested terms as search criteria.
    The category lookup is being executed in the current catalog and locale.

    **Returns:**

    - a iterator containing a [SuggestedCategory](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.SuggestedCategory.md) instance for
      each found category, the iterator might be empty

    **See Also:**

    - [Suggestions.hasSuggestions()](/docs/commerce/b2c-commerce/references/b2c-script-api/dw.suggest.Suggestions.md#hassuggestions)

***