> For the complete documentation index, see [llms.txt](https://ctracker-docs.keywordrush.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ctracker-docs.keywordrush.com/putting-it-on-your-pages/blocks.md).

# Blocks

Four blocks for the WordPress editor. Each previews live as you edit — what you see in the editor is what the page renders.

| Block                | Puts on the page               |
| -------------------- | ------------------------------ |
| **Cashback shops**   | A grid of shop tiles           |
| **Cashback coupons** | A list of coupons              |
| **Shop search**      | The shop search box            |
| **Cashback balance** | The logged-in member's balance |

Find them under **Cashback Tracker** in the block inserter.

![The four blocks in the inserter](https://3545740495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M69sU0hfZj3QsteYxmI%2Fuploads%2Fgit-blob-353a3e307780007d8fa877645acc8c6f06dd4cae%2Fblock-inserter.webp?alt=media)

### Cashback shops

| Setting               | Notes                                                                   |
| --------------------- | ----------------------------------------------------------------------- |
| **Layout**            | *Grid* for the full tile, *Compact* for the tighter one a sidebar wants |
| **Shops to show**     | How many                                                                |
| **Columns**           | Leave it alone and the grid fills the space it is given                 |
| **Category**          | One shop category                                                       |
| **Sort**              | Newest, name, cashback rate or member rating                            |
| **Include / Exclude** | Specific shop pages                                                     |

*Compact* drops the tagline and the star rating. It keeps the shop's name and its rate — a tile with neither gives a visitor no reason to click.

![The Cashback shops block, picking shops by name](https://3545740495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M69sU0hfZj3QsteYxmI%2Fuploads%2Fgit-blob-36e1ead3a6d7e655e0e0034051f94bb304432708%2Fblock-shops-settings.webp?alt=media)

### Cashback coupons

| Setting                  | Notes                                                                 |
| ------------------------ | --------------------------------------------------------------------- |
| **Source**               | *This shop* follows the page it sits on; *Chosen shops* lets you pick |
| **Shops**                | The picker, when the source is *Chosen shops*                         |
| **Type**                 | All, codes only, or deals only                                        |
| **Origin**               | All, *Added by hand*, or *From the network*                           |
| **Coupons to show**      | How many                                                              |
| **Layout**               | *List* or *Compact*                                                   |
| **Show the shop domain** | Worth turning off when every coupon is from the same shop             |

**Source: This shop** is what makes one block work in a shop template — it reads the shop from whichever page it is rendering on, so a single block in your theme serves every shop.

{% hint style="info" %}
The *Recently expired* section appears only in the **List** layout. Compact is a sidebar list, and has no room for it.
{% endhint %}

### Shop search and Cashback balance

Neither needs configuring. The search box takes a placeholder; the balance takes nothing at all and renders nothing for a logged-out visitor.

### Blocks or shortcodes?

They render exactly the same thing — the block builds the shortcode's arguments and hands them to the same code.

Use **blocks** when you are working in the editor and want to see the result while you place it. Use [**shortcodes**](/putting-it-on-your-pages/shortcodes.md) in classic editors, widget areas, page builders, or a theme template.

One difference worth knowing: the Coupons block's *This shop* source has no shortcode equivalent by that name — the shortcode expresses it as `shop="…"`, naming the page explicitly. See [`[cashback-coupons]`](/putting-it-on-your-pages/shortcodes/cashback-coupons.md).

### Related

* [Shortcodes](/putting-it-on-your-pages/shortcodes.md)
* [Widgets](/putting-it-on-your-pages/widgets.md)
* [Colours and CSS](/putting-it-on-your-pages/colors-and-css.md)