Create a One-Click Action Button

A button is a UI element that allows you to create a one-click action in a workbook. You can customize how a button is displayed and configure it to open an external link, open a Sigma document (workbook, dataset, connection table, etc.), redirect to a specific destination in the current workbook, or initiate a PDF download.


Summary of Content

User Requirements

Create a One-Click Action Button

Open an External Link

Open a Sigma Document

Go to Target on This Workbook

Download as PDF


User Requirements

The ability to create elements in a workbook requires the following:

  • You must be assigned an account type with the Explore Workbook or Edit Workbook permission enabled.
  • You must be the workbook owner or be granted Can Explore or Can Edit workbook permission.

Create a One-Click Action Button

  1. In the navigation menu, click Add element to open the Add New panel.
  2. In the Elements tab, go to the UI Elements section and select Button.
  3. In the Element properties panel, configure the display-related fields:
    • Label - Enter a label or call to action (CTA) text.
    • Appearance - Select a button style.
    • Horizontal align - Align the button relative to the total element width.
  4. Select an Action option to determine the one-click action:
  5. Refer to the following sections and configure the relevant action-related fields.

Open an External Link

Configure the following fields to create a button that opens a webpage external to Sigma:

  • Link URL - Enter the external webpage URL.
  • Open in - Determine how the linked page opens in the browser.

    The Same window and Parent window options both open the linked page in the current browser window; however, Same window applies to workbooks accessed directly in Sigma, while Parent window applies to embedded workbooks only. When selecting an Open in option, consider how report consumers will access the workbook.

Open a Sigma Document

Configure the following fields to create a button that opens a Sigma workbook, dataset, connection table, etc.:

  • Page - Enter the target document's URL slug.

    The slug is the part of the target document URL that follows your organization name, beginning with a forward slash (/).

  • Open in - Determine how the linked document opens in the browser.

    The Same window and Parent window options both open the linked document in the current browser window; however, Same window applies to workbooks accessed directly in Sigma, while Parent window applies to embedded workbooks only. When selecting an Open in option, consider how report consumers will access the workbook.

Go to Target on This Workbook

Configure the following field to create a button that redirects to a specific page or element in the current workbook:

  • Target - Select the target page or element.

Download as PDF

Configure the following field to create a button that initiates a PDF download containing the current page or entire workbook:

  • Orientation - Select the downloadable content and PDF output orientation.

Permissible users can initiate a PDF download when accessing the workbook directly in Sigma. To enable PDF download in a private or application embed, append :allow_export=true to the embed URL. Users cannot download a PDF when viewing the workbook in a public embed.


Related Resources


Was this page helpful?
Yes No