---
category: [Administration & Integrations, Platform and Product Extensions, Platform and Product Extensions/Integration, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Workday Extend]
keyword: [Extend, Presentation Components, widgets, tags, UI components]
nav: wcp_docs
parent_url: /wcp_docs/
title: buttonGroup
layout: subsection
wd_wcptag: buttonGroup
---

<a id="section_N10021_N1001E_N10001"></a>
Creates a drop-down button that contains a list of page navigation buttons. The `action` attribute of the `buttonGroup` tag determines the button display type. The individual buttons display as options in the drop-down list.

Use `buttonGroup` on view and edit pages.

## <a id="section_mb5_lyf_h2b"></a>Example

This sample `buttonGroup` displays a list of options that navigate to the sample <i>expenseSummary</i> and <i>expenseItems</i> pages. The sample <i>expenseItemsButton</i> sends the <i>startDate</i> parameter to the <i>expenseItems</i> page.

```
{
 "type": "buttonGroup",
 "id": "expenseButtonGroup",
 "label": "Go to:",
 "action": "LINK",
 "children": [
   {
     "type": "button",
     "id": "expenseSummaryButton",
     "label": "Team Expense Summary",
     "taskReference": {
       "taskId": "expenseSummary"
     }
   },
   {
     "type": "button",
     "id": "expenseItemsButton",
     "label": "Expense Items",
     "taskReference": {
       "taskId": "expenseItems",
       "parameterBindings": {
         "startDate": "2021-03-15"
       }
     }
   }
 ]
}
```

## <a id="section-mobile-support"></a>Mobile Support

Android, iOS

## <a id="section_qpw_1kc_ccb"></a>Attributes

-   <b>action</b>

    Data type: string

    The display style of the button. Valid values:

    -   `PRIMARY` - Displays a button with high emphasis. This display style is typically for designating the primary action that moves the user forward in a process.
    -   `AUXILIARY` - (Default) Displays a button with medium emphasis. This display style is typically for:

        -   Secondary actions on a screen.
        -   Canceling a process.
        -   Taking an action that moves the user away from a process.

    -   `LINK` - Displays a link. This display style is for a page navigation option. Not supported in the Workday mobile app.

-   <b>children</b>

    Data type: list of button objects

    An array of `button` or `dropDownButton` tags displayed in the `buttonGroup`.

-   <b>id</b>

    Data type: binding-String

    Unique identifier used to reference this widget from other tags.

    Notes:

    -   The `id` must start with a letter.
    -   The `id` must be unique per page.
    -   To enable other widgets to reference this widget `id`, place this widget before the other widgets on the PMD. The PMD validation returns an "Undefined variable" error if it doesn't find a previously defined `id` in the PMD.
    -   Workday recommends that you include the `id` in your tag definitions for debugging purposes.

-   <b>label</b>

    Data type: dynamicBinding-String

    The text that displays on the button.

-   <b>render</b>

    Data type: binding-Boolean

    If true, this tag renders as a widget on the page. If false, the loaded page doesn't add this tag or its children. The default is true.

    Unlike the `visible` attribute, when `render` is false, other tags on the page can't reference this tag or widget on edit pages. On view pages, a tag can't reference other tags regardless of the `render` attribute value.

-   <b>sortOrder</b>

    Data type: binding-String

    When you set `sorted` to true on the `section` or `fieldSet` parent of this widget, the `sortOrder` attribute determines the order of this widget within its parent. The sort order is relative to the siblings of the widget.

    Typical values are "a", "b", "c", and so on. Example: The widget with `"sortOrder": "a"` displays before the widget with `"sortOrder": "b"`.

    <b>Note:</b> The `sortOrder` doesn't apply to sorting data on the widget. `sortOrder` only applies to the placement order of the widgets within the parent widget.



### Related Information

[Tutorial: Navigate Pages with Buttons and Button Groups](https://wd5.myworkday.com/workday/learning/course/62d106356d1b10051260edf509b90000?type=9882927d138b100019b928e75843018d)