> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Buttons

> A row of action buttons placed in a dashboard's grid: create a record, jump to a page, run a workflow, filter another block.

## Overview

The **Buttons** block puts a row of [action buttons](https://docs.custral.com/surfaces/views/action-buttons.md) anywhere in a dashboard's grid, sized and placed like any other block. Use it when a dashboard needs a call to action of its own (**Log a ticket**, **Run nightly sync**, **Show my deals only**) rather than another button in the view header.

They are the same buttons a view header carries, with the same editor and the same behaviour. Only where they sit differs.

## What a button can do

| Type | What clicking it does |
| - | - |
| **Create record** | Opens the new-record form for an object |
| **Go to page** | Jumps to another page |
| **Start conversation** | Opens a blank conversation |
| **Run workflow** | Triggers a workflow on demand |
| **Apply filter** | Filters **another block on this dashboard** to a saved set of conditions |
| **Open link** | Opens an external URL in a new tab |

A Buttons block has no filters of its own, so an Apply filter button always points at one of the other blocks on the dashboard. Every button can also **Ask first**, showing a confirm before it runs. The record-only types (Create linked record, Open related, Create quote) are not offered here.

## Configuration

| Setting | What it does |
| - | - |
| **Alignment** | Left, Center or Right: where the row of buttons sits in the block. |
| **Button size** | Small, Medium or Large. Small reads as a toolbar; Large reads as a call to action. |

The buttons themselves are not in the settings form. In edit mode, a new block shows **Add buttons**, and a block with buttons shows **Edit** at the end of the row. Either opens the actions editor, where you add, configure, reorder and label each button, then click **Save actions**.

## Steps

**1. Add the block**

Open the dashboard, click the gear (**Edit views**), and pick **Buttons** from the Blocks panel.

**2. Set the layout**

Choose the alignment and button size, then **Add to dashboard**.

**3. Add the buttons**

Click **Add buttons** in the block, add an action for each button, and **Save actions**.

## Troubleshooting

| Symptom | Fix |
| - | - |
| "This block has no buttons configured." | Nobody has added buttons yet. Someone who can edit the view adds them in edit mode. |
| No **Add buttons** or **Edit** control | You are not in edit mode, or you can view the dashboard but not edit it. Editing the buttons needs edit access on the view. |
| "This view has no blocks to filter yet." | The dashboard has no other block for an Apply filter button to point at. Add the block you want to filter first. |
| A Run workflow button reports a failure | The workflow itself errored. The toast carries its message, and the run is in the workflow's history. |

## See also

* [Action buttons](https://docs.custral.com/surfaces/views/action-buttons.md): every action type, Ask first, and the buttons on records.
* [Label](https://docs.custral.com/blocks/embedded/label.md): a heading or note in the grid.
* [Workflows](https://docs.custral.com/automation/workflows/overview.md): what a run-workflow button starts.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.