# How to Set Column Groups

Columns in Kanban Dashboard can be put into groups.

{% hint style="info" %}
This is not required. Groups are commonly used for visual and informational purposes.
{% endhint %}

To manage groups on your dashboard you need to select one of columns (click on column header). Group form will be shown in sidebar.

Select a group which current column will belong to or click "new" link to create a new group:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FUMUSaZZupKbtyZ6mS5wS%2Ffile.excalidraw.svg?alt=media&#x26;token=ceada951-6086-4e00-90b9-31e4a9387c98" alt="" class="gitbook-drawing">

### Adding new group

After clicking "new" link a "Create new group" dialog popup will appear. You required to give group a name and you may change group columns set and order:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FgSJI4imoiBFu7W3mXmJu%2Ffile.excalidraw.svg?alt=media&#x26;token=6253f35d-a547-4c2c-9693-28a14d78f6ba" alt="" class="gitbook-drawing">

Click "Create" button to apply changes. New group will be created and selected:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2F4AFVgqfJdTvFUMchIGbo%2Ffile.excalidraw.svg?alt=media&#x26;token=b9936b73-669a-425b-b117-8d191a610144" alt="" class="gitbook-drawing">

{% hint style="warning" %}
Note: if you select non-neighbor columns to be in the group, but they will be placed together.
{% endhint %}

### Adding or moving column to existing group

There are two ways to do this:

1. Select a column (belonging to any group or not). Then select a group in the "Group" picklist in the sidebar:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FmECTJg94Hu6MFjqPAgHu%2Ffile.excalidraw.svg?alt=media&#x26;token=485024a6-701e-45ea-8d45-3bea08aafb67" alt="" class="gitbook-drawing">

The column will be added to selected group and moved to the last position in it:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FynT8zZbHqXkHNLOGnJN0%2Ffile.excalidraw.svg?alt=media&#x26;token=c281a377-0c2b-45de-b329-395ad3cd21b8" alt="" class="gitbook-drawing">

2. Click a proper group header to see Group Properties sidebar. Move columns in the column picker to "Columns in Group" section:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2F3Cw7pnXSALPwiGi4st8D%2Ffile.excalidraw.svg?alt=media&#x26;token=d521495e-cd96-4ecf-896b-2f9543a8ee0a" alt="" class="gitbook-drawing">

### Removing column from the group

There are three ways to do this:

1. Select a column. Select "--None--" in the "Group" picklist:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FpzMCDfeK3ZUmxAxEykQD%2Ffile.excalidraw.svg?alt=media&#x26;token=91e013c2-4058-4711-b953-d3a410f139d9" alt="" class="gitbook-drawing">

Column will be moved out of group to the first position after it:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FVd3G3jqHoA83adEABpxc%2Ffile.excalidraw.svg?alt=media&#x26;token=596c3825-b6c4-4729-b335-c13483f17212" alt="" class="gitbook-drawing">

2. Click a proper group header to see Group Properties sidebar.  Remove columns in the column picker from "Columns in Group" section:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2F93IGffVItT11qMEnghni%2Ffile.excalidraw.svg?alt=media&#x26;token=9cd743eb-8fb4-4fe1-81f3-c79802799c1e" alt="" class="gitbook-drawing">

3. Delete a group without deleting columns (see below).

### Deleting groups

To delete a group select it by clicking a group header and click "Delete" button on the toolbar:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FnIWAtXLUmxioaqzJWJVk%2Ffile.excalidraw.svg?alt=media&#x26;token=6483c20b-c2dd-430c-b699-ef80bdf9ba95" alt="" class="gitbook-drawing">

Or click "Delete Group" button at the group header:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2Fy61kl55GwKfQQigKZMXQ%2Ffile.excalidraw.svg?alt=media&#x26;token=cbac569b-76d7-4003-886b-d10d59f9c4e6" alt="" class="gitbook-drawing">

A dialog popup will appear. Select an appropriate option and click "OK" button:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FkGac2fYJppuyrozWUnfD%2Ffile.excalidraw.svg?alt=media&#x26;token=b8f4df19-e4d1-4c5a-8f15-597e19181ebb" alt="" class="gitbook-drawing">

If you select "Delete group and all it's nested columns", a whole group and columns that belong to it will be deleted.

If you delete only group, it's columns will remain on the same positions on dashboard.

### Configuring groups

Select a group and click "edit" link near the "Config" label:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FBphQ2hiiqh1oJoc5WifC%2Ffile.excalidraw.svg?alt=media&#x26;token=0690d424-811a-4de2-a29b-c676ddbc172f" alt="" class="gitbook-drawing">

An "Edit Group Config" dialog popup will be shown. Select "Header Group Configuration" tab:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FIocFE3B12wLkuiiz5pxg%2Ffile.excalidraw.svg?alt=media&#x26;token=b04bed1d-347b-4d91-9ee1-a0d60254bd55" alt="" class="gitbook-drawing">

* Set CSS styles of group header and container.
* Check "Collapsible?" to give a group proper ability.
* "Collapsed" checkbox will be shown only if "Collapsible?" is checked and allows to set default column state (collapsed or not)

Add Cells:

* Select Type  (text/link/icon/menu).
* Set ID, Value, CSS styles.
* Configure Handler, if necessary.
* Click "Apply" to save changes in group configuration and save dashboard.

Select "Filters Configuration" tab:

<img src="https://3097383375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK2dgObBO5ydOH2ZXDJLa%2Fuploads%2FiL82pt661Ng6VLWUkBGM%2Ffile.excalidraw.svg?alt=media&#x26;token=0193a927-dd2d-4fab-a068-8d2561497459" alt="" class="gitbook-drawing">

* Select filtering:
  * Allowed - column can be filtered by both default (system) data sources and custom filters
  * Allowed only Default Sources - column can be filtered only by default (system) data sources
  * Allowed only Custom Sources - column can be filtered only by custom filters
* Click "Apply" button to save changes in group configuration and save dashboard.
