# Group & Ungroup
The group and ungroup methods, group and ungroup tagged objects in the same way that Illustrator's UI groups and ungroups a selection.
Currently the header's property cells cannot be left blank, so if you have set the tagSearch by using the top row of the spreadsheet's header and have not set other properties, set the property to *, skip or tagSearch. This will prevent an error being flagged on the property cell, you can leave the filler property's values blank.
To prevent the method being applied to a row, inside the method, use either the generic * property and set the cell value to false or the generic skip property and set the cell value to true.
To apply tags to the newly grouped item, use the tags property and provide a list of tags.
# Example Spreadsheet
| cat | dog | mouse | * | ||
| group | ungroup | comment | |
| * | tagSearch: trees | skip | * |
trees | Both group and ungroup will be applied | ||
| FALSE | trees | group will be skipped, group's * property is set to false | |
trees | TRUE | ungroup will be skipped, ungroup's skip property is set to true | |
| "" | ungroup will be skipped, ungroup's tagSearch property is set to "" | ||
| TRUE | trees | FALSE | Both group and ungroup will be applied |
# Group and Ungroup Properties
| Mode | Description |
|---|---|
tagSearch | The tag search of the items to group or ungroup Example Values: cat | dog | mouse, trees |
* | Set to false if you want the method to be skipped in a particular row. Valid Values: true or false |
skip | Set to true is you want the method to be skipped in a particular row. See * and Skip for details. Valid Values: true or false |
tags for group method only | A list of tags to apply to the newly grouped object. Example Values: animals, pets, creatures |