# Search cards macro

Cards suit a landing page where a table would look like a report. Same saved search, same visibility rules, different presentation.

Use it where the result set is small and the point is to invite a click.

---

## Settings

| **Setting**                                           | **What it changes**                                                                                                                                                                                      |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search cards (Capable) / Search cards macro (Capable) | Renders a saved search as cards. Same visibility rules as the table macro.                                                                                                                               |
| Page Size                                             | Sets how many results the macro requests from Confluence. On the table this is the rows-per-page. On the cards it is only the fetch size, cards always show 12 per page client-side.                     |
| Background                                            | Card fill. When set, the card's text colour is auto-derived from the fill's luminance (near-black on light fills, near-white on dark) unless you set Text explicitly.                                    |
| Text                                                  | Card text colour. It is honoured only while it keeps at least 3:1 contrast against whatever surface the card actually sits on; below that the macro silently falls back to a luminance-derived colour (o |
| Accent                                                | Draws a 3px left accent bar on every card.                                                                                                                                                               |
| Corner radius                                         | Card corner rounding; also rounds the top of the cover image.                                                                                                                                            |
| Gap                                                   | Gutter between cards in the responsive grid (1 / 2 / 3 / 4 columns by breakpoint).                                                                                                                       |
| Shadow                                                | Card drop-shadow depth. Cards always brighten to a large shadow on hover regardless of this setting.                                                                                                     |
| Border                                                | When off the card keeps its default 1px theme border. When on, the configured width and colour replace it entirely.                                                                                      |
| Show excerpt                                          | Adds a 3-line clamped text preview under the card title, built by stripping HTML from Confluence's own search excerpt.                                                                                   |

---

## Table or cards

| **Use** | **When**                                                  |
| ------- | --------------------------------------------------------- |
| Table   | Many results, and the columns carry the meaning           |
| Cards   | Few results, and the point is to get somebody to open one |

---

## A few things worth knowing

* Cards show fewer fields than a table by nature. Choose the saved search accordingly.
* Both macros render for anonymous readers.
* The two macros can point at the same saved search.

---

## Related

[Search table macroThe row version.](https://help.gocapable.com/search/search-table-macro.html)

[Working with saved searchesWhat it points at.](https://help.gocapable.com/search/working-with-saved-searches.html)

[FormattingOther card macros.](https://staging.dev.capable-sites.com/wiki/pages/1413120256)

---

_Same search. Different shape._