# Transaction List

A purpose-built layout container for transaction-list pages. Provides a top **Filters** slot and a bottom **Table** slot, with controls for spacing and an optional Clear All Filters button.

This block is the standard wrapper for any page where the user is browsing transactions with filters.

![Transaction List layout with filter controls in the top section, a Clear All Filters button below them, and a results table beneath](/files/l0HDirnvGcBNfEsgq0Ai)

## Available in

* Page modules **only**

Transaction List isn't available in Order Form, Catalog, Dashboard, Modal, Reports, or Navigation modules — it's purpose-built for the transaction-listing pattern in Page modules.

## When to use

* Any Page module that displays a filterable transaction list — orders, invoices, fulfilments, returns.
* Whenever you'd otherwise build a manual two-row layout with filters on top and a table below — this block has the right defaults baked in.

For dashboards or report pages without filtering, use a simple Row + Report Widget instead.

## Settings

| Setting                           | Description                                                                                       |
| --------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Gap**                           | Spacing in pixels between the filter section and the table. Range: 0–100. Default: 24.            |
| **Hide Filter Section**           | Hide the filters slot entirely. Show / Hide. Default: Show.                                       |
| **Show Clear All Filters Button** | Display a button that clears every active transaction filter. Default: No.                        |
| **Clear Button Position**         | Where the Clear button sits when shown: Under filters left or Under filters right. Default: Left. |
| **Filters**                       | Slot for filter blocks — typically Transaction List Filter, Customer Select, etc.                 |
| **Table slot**                    | Slot for the results table — typically Transaction List or a configured Report Widget.            |

## How it works

The block renders as a vertical flex container:

1. **Filters slot** at the top (hidden if Hide Filter Section is on).
2. The optional Clear All Filters button below filters, positioned left or right.
3. **Table slot** at the bottom, with a minimum empty height of 200px so the editor canvas doesn't collapse.

When Hide Filter Section is on, the gap between filters and table goes to 0 (since there's nothing above the table).

The Clear All Filters button calls the global transaction-filter clear action, which resets every filter block on the page in one go.

{% hint style="info" %}
For pages with a single filter, the Clear All Filters button is overkill. Enable it when you have three or more filter blocks and want to give users a quick reset.
{% endhint %}

## Examples

**Order history page.** Transaction List with Filters slot containing Transaction List Filter (date range, status). Table slot containing Transaction List configured for sales orders. Clear All Filters enabled, position right.

**Invoice browser.** Transaction List with Customer Select + Transaction List Filter in the Filters slot, Transaction List in the Table slot, Hide Filter Section off, gap 32.

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Transaction List Filter</strong></td><td>The filter block that goes in the Filters slot.</td><td><a href="/pages/1qdFnI1BuBf3ocBi0hqu">/pages/1qdFnI1BuBf3ocBi0hqu</a></td></tr><tr><td><strong>Transaction Search</strong></td><td>An alternative search-driven view for finding specific transactions.</td><td><a href="/pages/3LyKFu6XjQ0sX6BaDIUd">/pages/3LyKFu6XjQ0sX6BaDIUd</a></td></tr><tr><td><strong>Report Widget</strong></td><td>For non-transaction tabular data.</td><td><a href="/pages/iL4LHW8eadVrU4Dz2iRe">/pages/iL4LHW8eadVrU4Dz2iRe</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.in8sync.com/client-admin-guide/active-workflows/getting-started/layout-components/transaction-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
