# Single-Select or Multi-Select Pill Tabs Group

## Overview

![Multi-select preview](https://content.gitbook.com/content/SSunCeiuKbDNt2RTgRa6/blobs/p474Z2GxmYQ4yIfk57Tf/pills1.png)

![Single-select preview](https://content.gitbook.com/content/SSunCeiuKbDNt2RTgRa6/blobs/Fysed9Awmu0pqU5NItQP/pills2.png)

![Editor view](https://content.gitbook.com/content/SSunCeiuKbDNt2RTgRa6/blobs/6A4RQAbGffyehoOnC2ce/pills3.png)

This block includes the Multiselect Pills visual element from the Canvas UI elements plugin.&#x20;

## Structure

* The **CanvasMultiselectPills** plugin element can display any list of Things in pill-shaped tabs. The pills are responsive in width and will adjust based on the display text of each pill.&#x20;
* By default, the pill style will utilize your app's primary colors. You can adjust the styling within the property editor of the visual element.&#x20;

## How to set up multi-select tabs

* In the **CanvasMultiselectPills** plugin element's property editor, update the type of content and data source of the plugin element.&#x20;
* If you are using this element to filter a repeating group, add a constraint to your repeating group, which utilizes the "Current selected" state of the plugin:

![](https://content.gitbook.com/content/SSunCeiuKbDNt2RTgRa6/blobs/Y4m6qKdST0i8drGW9Vn0/pills4.png)

{% hint style="info" %}
You do not need to add any workflows for the multi-select functionality. The plugin element has multi-select functionality built into it.
{% endhint %}

## How to set up single-select tabs

* In the **CanvasMultiselectPills** plugin element's property editor, change the selection style from "Multiple Selection" to "Single Selection".

![](https://content.gitbook.com/content/SSunCeiuKbDNt2RTgRa6/blobs/7VAq82OaZzR70CPIfsyZ/pills5.png)

* In the **CanvasMultiselectPills** plugin element's property editor, update the type of content and data source of the plugin element.&#x20;
* If you are using this element to filter a repeating group, add a constraint to your repeating group, which utilizes the "Current selected" state of the plugin:

![](https://content.gitbook.com/content/SSunCeiuKbDNt2RTgRa6/blobs/UTrprNo7aA20jbneZOno/pills6.png)

{% hint style="info" %}
You do not need to add any workflows for the single-select functionality. The plugin element has single-select functionality built into it.
{% endhint %}

## Other customization options

* Change the alignment of the tabs from "left-justified" to "centered" or "right-justified" through the property editor's alignment dropdown.&#x20;
* Change the responsive behavior of the tabs from "wrap to the next line" to "scroll horizontally" or "scroll vertically" through the property editor's flow dropdown.&#x20;
