> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/algolia/docsearch/llms.txt
> Use this file to discover all available pages before exploring further.
# Searching Multiple Indices
> Learn how to search across multiple Algolia indices simultaneously with DocSearch
DocSearch supports searching multiple Algolia indices in a single query, allowing you to aggregate results from different data sources like documentation, blog posts, API references, and more.
## Using the `indices` Prop
The `indices` prop accepts an array of index configurations. Each index can be specified as a string (index name only) or as an object with index-specific search parameters.
### Basic Multiple Indices
Search across multiple indices with default settings:
```jsx theme={null}
import { DocSearch } from '@docsearch/react';
```
## Index-Specific Search Parameters
Each index can have its own search parameters to customize how results are retrieved and ranked:
```jsx theme={null}
```
The `indices` prop replaces the deprecated `indexName` and `searchParameters` props. While the old props still work for backward compatibility, new implementations should use `indices`.
## TypeScript Interface
```typescript theme={null}
interface DocSearchIndex {
name: string;
searchParameters?: SearchParamsObject;
}
interface DocSearchProps {
// ... other props
indices?: Array;
}
```
## Common Search Parameters
When configuring index-specific parameters, you can use any Algolia search parameter:
### Filtering Results
```jsx theme={null}
indices={[
{
name: 'documentation',
searchParameters: {
facetFilters: ['language:en', 'version:v2'],
filters: 'category:tutorial OR category:guide'
}
}
]}
```
### Controlling Result Display
```jsx theme={null}
indices={[
{
name: 'documentation',
searchParameters: {
hitsPerPage: 15,
attributesToSnippet: [
'hierarchy.lvl1:10',
'content:15'
],
snippetEllipsisText: '…',
highlightPreTag: '',
highlightPostTag: ''
}
}
]}
```
### Analytics
```jsx theme={null}
indices={[
{
name: 'documentation',
searchParameters: {
clickAnalytics: true
}
}
]}
```
When `insights` is enabled at the top level, `clickAnalytics` is automatically enabled for all indices unless explicitly overridden.
## Mixing with Other Features
### Multiple Indices with Ask AI
You can use multiple indices for keyword search while configuring Ask AI separately:
```jsx theme={null}
```
### Multiple Indices with transformItems
The `transformItems` function receives hits from all indices:
```jsx theme={null}
{
return items.map((item) => {
// Add a badge based on index
const indexName = item.__autocomplete_indexName;
return {
...item,
hierarchy: {
...item.hierarchy,
lvl0: `[${indexName}] ${item.hierarchy.lvl0}`
}
};
});
}}
/>
```
## Migration from Deprecated Props
The `indexName` and top-level `searchParameters` props are deprecated and will be removed in a future version.
### Before (Deprecated)
```jsx theme={null}
```
### After (Recommended)
```jsx theme={null}
```
## Best Practices
Keep the number of indices reasonable (typically 2-5) to maintain fast search performance.
Use `hitsPerPage` and `maxResultsPerGroup` to control how many results appear from each index.
Use index-specific `facetFilters` and `filters` to ensure results are relevant to the current context (e.g., user's selected version, language, or category).
## Complete Example
Here's a complete example searching across documentation, blog, and API reference indices:
```jsx theme={null}
import { DocSearch } from '@docsearch/react';
import '@docsearch/css';
function App() {
return (
);
}
```