> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://help.sigmacomputing.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server. # Button elements > Add Sigma button elements for one-click workbook actions like workflows, navigation, exports, and API calls. Add a button to create a one-click interaction in a workbook or application. You can customize the button display with text and icons, and configure it to trigger actions that kick off workflows, navigate to a specific destination, modify or refresh elements, export data, call APIs, and more. Buttons are a [UI element](/docs/intro-to-ui-elements), allowing you to stylize workbooks and create seamless interactive experiences. This document explains how to create and customize a button element. For information about actions and action sequences that can execute when the button is clicked, see [Action effects](/docs/intro-to-actions#action-effects). ## User requirements The ability to create and customize a button element requires the following: * You must be assigned an [account type](/docs/account-type-and-license-overview) with the **Full explore** or **Create, edit, and publish workbooks** permission enabled. * You must be the workbook owner or be granted **Can explore** or **Can edit** [access to the workbook](/docs/folder-and-document-permissions). ## Add a button element Add a **Button** element to your workbook. 1. Open a draft, custom view, or saved view of a workbook. 2. In the **Add element** bar, hover over **UI** and select **Button**. ![An image of the Add element bar with the UI > Button option highlighted for selection](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/sigma.docs.buildwithfern.com/bdc300b27e39fb61dceeb3a5db07cc0e24ffe6afa860c9a017092e5702f183e3/assets/docs-images/4dbd31399072708b3936c8dce542780722c4b63a35a4045643fa15bb4be15d7f-image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260914%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260914T204744Z&X-Amz-Expires=604800&X-Amz-Signature=6d52a9e0fc37507c87ef087cfa61ae27c3f16f10d0d95006171357d6c557908e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## Customize button properties You can customize the element properties that define the button's appearance, including the label, style, alignment, shape, and size. In the editor panel, select the **Properties** tab, then configure the following settings for the button: | Options | Details | | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Button type** | Select a button type variant from among **Text**, **Icon**, or **Text and icon**. | | **Appearance** | Select a button variant from among **Filled**, **Outline**, and **Text**. | | **Text** | Add a label to display in the button. Select `=` on your keyboard to include a dynamic value defined by a formula expression. *Available when **Button type** is set to **Text** or **Text and icon**.* | | **Style** | Customize the font weight, text color, and button color. | | **Horizontal** | Align or stretch the button relative to the total element width. | | **Vertical** | Align the button relative to the total element height. | | **Shape** | Select a button shape from among **Auto**, **Square**, **Round**, and **Pill**. | | **Size** | Select a button size from among **Small**, **Medium**, and **Large**. | | **Icon** | Select an icon to appear in the button. *Available when **Button type** is set to **Icon** or **Text and icon**.* | | **Tooltip** | Turn on the toggle to enable custom on-hover text for the button. *Available when **Button type** is set to **Icon**.* | | **Position** | Select **Start** or **End** to set the position of the icon relative to the text. *Available when **Button type** is set to **Text and icon**.* | You can search for icons that fit your design needs. After selecting **Change icon** in the **Properties** tab, you can search for an icon by its name using the search bar. Additionally, you can search by category by selecting between **All**, **Filled**, **Outlined**, **Toned**, and **Emoji**. ## Configure button actions Configure actions and action sequences that execute when the button is clicked. 1. In the editor panel, select the **Actions** tab. 2. Configure actions and action sequences as needed. For information about specific action effects and how to configure them, see [Action effects](/docs/intro-to-actions#action-effects) and the documentation linked in the table. ## Related resources * [Intro to UI elements](/docs/intro-to-ui-elements)