# Search summary

<figure><img src="https://3723856256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGnixyIfIYFWroNtVmZo6%2Fuploads%2Fgit-blob-5dafe735974f9e668059c146a920706253c52674%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Overview

A search results summary block that displays the number of search results found and the search terms entered by the user. The block only renders when search results are present and provides configurable styling options for text appearance, spacing, and layout.

## Common use cases

* Place this block at the top of search results pages for clear user feedback
* Use consistent styling with your search form and results layout
* Consider using center alignment for standalone search summary displays
* Enable max-width for better readability in wide layouts
* Adjust font size based on the importance of search feedback in your design
* Use appropriate padding to ensure proper spacing within search result containers

## Block settings

### General

| Setting                | Description                 | Options                   |
| ---------------------- | --------------------------- | ------------------------- |
| Show advanced settings | Reveals visibility settings | Checkbox (default: false) |

### Spacing

| Setting                   | Description                                | Options                   |
| ------------------------- | ------------------------------------------ | ------------------------- |
| Enable horizontal padding | Adds horizontal padding around the summary | Checkbox (default: false) |
| Enable top padding        | Adds top padding around the summary        | Checkbox (default: false) |
| Enable bottom padding     | Adds bottom padding around the summary     | Checkbox (default: false) |

### Color

| Setting    | Description             | Options                                                                                                                                                                                                                                                      |
| ---------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Text color | Controls the text color | <p>• Default (default)<br>• Alternative<br>• Primary background<br>• Primary foreground<br>• Secondary background<br>• Secondary foreground<br>• Tertiary background<br>• Tertiary foreground<br>• Neutral background<br>• Neutral foreground<br>• Shade</p> |

### Style

| Setting     | Description                                | Options                                                                                                                                                           |
| ----------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Font family | Controls the font family used for the text | <p>• Standard<br>• Heading<br>• Subheading<br>• Accent<br><br>Visible when font size contains 'type--'</p>                                                        |
| Font size   | Controls the font size of the text         | <p>• Smaller<br>• Small<br>• Default (default)<br>• Big<br>• Bigger<br>• Heading 1<br>• Heading 2<br>• Heading 3<br>• Heading 4<br>• Heading 5<br>• Heading 6</p> |

### Layout

| Setting              | Description                                  | Options                                                     |
| -------------------- | -------------------------------------------- | ----------------------------------------------------------- |
| Horizontal alignment | Controls horizontal text alignment           | <p>• Left (default)<br>• Center<br>• Justify<br>• Right</p> |
| Enable max width     | Limits the maximum width of the text content | Checkbox (default: false)                                   |

### Display

| Setting    | Description                        | Options                                                                                                                            |
| ---------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Visibility | Controls when the block is visible | <p>• All (default)<br>• Mobile only<br>• Desktop only</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p> |
