---
title: "startUndoGroup(_:)"
framework: Professional Video Applications
role: symbol
role_heading: Instance Method
platforms: [fxplug 3.1+]
path: "professional_video_applications/fxundoapi/startundogroup(_:)"
---

# startUndoGroup(_:)

Begins a new undo group.

## Declaration

```swift
func startUndoGroup(_ name: String!) -> Bool
```

## Parameters

- `name`: The name of the undo group. Some hosts may display this name in their undo menu. This name should be localized and suitable for user display.

## Return Value

Return Value true if the undo group was successfully started; otherwise false.

## Discussion

Discussion A plug-in can use this method to collapse multiple operations into one undo operation. Subsequent undo operations will be coalesced into this group until endUndoGroup() is called. Each call to startUndoGroup(_:) must be balanced with a call to endUndoGroup(). For example, a plug-in may implement a “preset” popup, which changes the values of 20 other parameters using the FxParameterSettingAPI. By nesting the parameter changes in a startUndoGroup/endUndoGroup block, the 20 changes will be collapsed into one undo operation. This allows the user to undo the preset app by hitting undo once, instead of once per each changed parameter.

## See Also

### Creating Undo Groups

- [endUndoGroup()](professional_video_applications/fxundoapi/endundogroup().md)