---
editLink: false
lastUpdated: false
---

[@salesforce/b2c-tooling-sdk](../../modules.md) / [docs](../index.md) / SearchDocsOptions

# Interface: SearchDocsOptions

Defined in: [packages/b2c-tooling-sdk/src/docs/search.ts:288](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1dedfc1ffefa01c3d5bff62c8f7e7e682a1a91cd/packages/b2c-tooling-sdk/src/docs/search.ts#L288)

Options for [searchDocs](../functions/searchDocs.md).

## Properties

### category?

> `optional` **category**: [`DocCategory`](../type-aliases/DocCategory.md) \| [`DocCategory`](../type-aliases/DocCategory.md)[]

Defined in: [packages/b2c-tooling-sdk/src/docs/search.ts:292](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1dedfc1ffefa01c3d5bff62c8f7e7e682a1a91cd/packages/b2c-tooling-sdk/src/docs/search.ts#L292)

Restrict results to one or more corpora/categories (hard filter).

***

### enabledCategories?

> `optional` **enabledCategories**: readonly [`DocCategory`](../type-aliases/DocCategory.md)[]

Defined in: [packages/b2c-tooling-sdk/src/docs/search.ts:311](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1dedfc1ffefa01c3d5bff62c8f7e7e682a1a91cd/packages/b2c-tooling-sdk/src/docs/search.ts#L311)

A hard allowlist of categories that bounds the ENTIRE available corpus for
this call — a configuration boundary, distinct from the per-query
[SearchDocsOptions.category](#category) filter and the soft workspace boost.

When set, only entries in these categories are ever eligible; any `category`
narrows *within* this set (their intersection wins). Intended to be resolved
once from a launch-time flag/env var (see [resolveEnabledCategories](../functions/resolveEnabledCategories.md)) so
operators can pin the docs surface to exactly the topics they want exposed.
`undefined` means no restriction.

***

### limit?

> `optional` **limit**: `number`

Defined in: [packages/b2c-tooling-sdk/src/docs/search.ts:290](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1dedfc1ffefa01c3d5bff62c8f7e7e682a1a91cd/packages/b2c-tooling-sdk/src/docs/search.ts#L290)

Maximum number of results to return (default: 20).

***

### workspace?

> `optional` **workspace**: [`ProjectType`](../../discovery/type-aliases/ProjectType.md) \| [`ProjectType`](../../discovery/type-aliases/ProjectType.md)[]

Defined in: [packages/b2c-tooling-sdk/src/docs/search.ts:299](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/1dedfc1ffefa01c3d5bff62c8f7e7e682a1a91cd/packages/b2c-tooling-sdk/src/docs/search.ts#L299)

The current workspace marker(s) (e.g. from workspace detection). When set,
the categories relevant to those markers rank higher (always a boost — never
hides anything). To hard-scope instead, use [SearchDocsOptions.category](#category)
or [SearchDocsOptions.enabledCategories](#enabledcategories).