A Button Row widget puts a row of buttons on a dashboard. Think of the shortcuts at the top of a page: each button opens a link, a form or a new record, or runs a script. The buttons can also show as tiles with the icon above the label.
Here is the test: should viewers do something from the page, not only read it? If yes, add a Button Row. For a button inside a grid or board widget, use that widget's own Buttons section; see View-Based Widget Buttons.
Example: under the Hero on the Vendor risk overview sit three buttons. Log a finding creates a record in Findings with Status set to New. Request assessment opens the Vendor intake request form in a popup. Open register opens the saved view in the same tab.
The Button Row on the Vendor risk overview: Log a finding, Request assessment and Open register, each with an icon.
Plan Availability | |
Permissions | Solution Managers and members with Full Access add and change widgets on a public dashboard; the owner does on a private one. |
Platform | Web |
Related Reading |
Adding a Button Row widget
Set the View | Edit switch in the upper right to Edit.
Select + Add Widget in the toolbar. The Add New Widget sidebar opens on the right with a Search Widget box and thirteen collapsible categories. Page Display is open to start.
Open Actions and select the Button Row card. Its info icon reads "Displays a row of customizable buttons".
The Button Row modal opens. The preview sits on the left and the settings on the right, on two tabs, General and Style. Three sample buttons are already in place. Change them or add your own, then select Add Widget at the foot.
The row lands at full width with no header. Drag it by its handle to move it.
The General tab
The General tab holds two sections: Heading and Buttons. Each button row opens the Button Settings popover.
Heading
Title is the widget's name, prefilled with "Button Row". Description is a switch, off to start; on, it adds a text box and the choice As A Tooltip or Below The Title.
Buttons
The list of buttons in their order. It ships with three sample rows, SmartSuite, Features and Workflows, each a link to a SmartSuite page. Hover over a row for a trash icon and a gear; the gear or the row opens the button's settings. Select Add Button under the list to add a row. The buttons in the preview are live: selecting one opens its link.
The General tab with the three overview buttons in the list and Add Button below.
The Button Settings popover
The popover opens beside the settings, with an X to close it. Its rows, in order:
Label: the text on the button; the placeholder reads "Enter label".
Icon: No Icon to start. It opens a searchable icon library, grouped by theme.
Color: an "Aa" swatch. It opens a palette of fifty swatches, blue to start, with lighter rows of the same hues and a gray row.
Action: Link to external URL to start. The list holds Link to external URL, Run a Script, Create a Record and Open a Form. The rows below change with the choice.
Show Tooltip: No | Yes, No to start. Yes adds a small rich-text box (bold, italic, underline and link; placeholder "Write here") that stops at 200 characters.
Ask for Confirmation: No | Yes, No to start. Yes adds Title "Are you sure?", Message "Are you sure you want to continue?" and Button Label "Yes, Continue", each editable.
Done saves the button and closes the popover.
Link to external URL adds URL (placeholder "Enter URL") and Open in, New Tab to start, with Same Tab or New Tab. Open register uses this with Same Tab.
Run a Script adds Execute, In a New Tab to start, with In a New Tab, In a Modal or On Click.
Create a Record adds Table, a Source Select that starts on the dashboard's own table, and Default Values with a Select Field control. The record is created when the viewer selects Save. The full steps are in Dashboard Button Action: Create a Record.
Open a Form adds Table, Form ("Select a Form") and Open in, Slider to start, with Popup, Slider, Full Screen or New Tab. Request assessment uses this with Popup.
Note: A Create a Record button makes the record only when the viewer saves it. Closing the record window leaves nothing behind.
The Button Settings popover for Request assessment, with Action set to Open a Form and Open in set to Popup.
The Style tab
The Style tab holds the Appearance section. Its rows change when the style is set to Card.
Appearance
Style is Button or Card. Button is chosen to start.
Button Size is Auto or Balanced. Balanced is chosen to start; its helper reads "Sets all buttons to the same width, spanning the entire column". With Auto the helper reads "Up to 8 per row with a minimum width of 150px for each button". An Align row then appears with left, center and right icons, left to start.
Buttons per row is Automatic or a number from 7 down to 1. It shows with Balanced; Auto removes it. The overview uses Balanced with 3.
Card style
With Card, each button becomes a tile with the icon above the label. The tab shows Cards per row (Automatic to start) and no size row. A card's popover adds a Style row, Solid or Border (Border gives a white tile with colored text and border), and Show Tooltip becomes Show Description. The description, up to 200 characters, renders on the tile under the label.
Tip: Card with a one-line description suits a request hub, where a viewer chooses between actions. Button suits plain navigation.
The Style tab with Style set to Card and Cards per row set to Automatic, three tiles in the preview.
Permissions
Solution Managers and members with Full Access add and change widgets on a public dashboard. The owner does so on a private one. Every member who can open the dashboard sees the buttons. See Dashboard Settings. A button does only what the viewer may do: a member who cannot create records in Findings does not get a working Log a finding.
Using the widget
In View mode a viewer selects a button. A URL opens in the tab you chose. A form opens in the popup, slider, full screen or new tab you chose. A new record opens prefilled and is created on Save. A script runs where you chose. Hover over a button and its tooltip shows in a dark bubble under it. With Ask for Confirmation on, a dialog opens first with your title and message, Cancel and the button label you set.
Editing a Button Row widget
In Edit mode, hover over the widget and select Edit in the strip that appears above it. The modal reopens; open a row's gear to change a button, use the trash to delete one, change the style, then select Save Changes at the foot. Cancel after a change asks "Are you sure you want to exit without saving the changes you made?", with Exit Without Saving and Save Changes. The strip's More Options menu holds Minimize, Highlight Color, Duplicate Widget, Delete Widget and Collapsed by Default; see Managing Widgets.
Frequently asked questions
How many buttons can a row hold?
How many buttons can a row hold?
With Auto size the helper says up to 8 per row, with a minimum width of 150 px each.
Which actions can a button run?
Which actions can a button run?
Link to external URL, Run a Script, Create a Record and Open a Form.
Can I ask the viewer to confirm first?
Can I ask the viewer to confirm first?
Yes. Set Ask for Confirmation to Yes in the button's settings and edit the title, the message and the button label.
Can a button open a form from another solution?
Can a button open a form from another solution?
The Table picker lists every solution you can see, then its tables.
Last verified 1 Nov 2026.




