1. Modeling
  2. Build Models
  3. Actions
  4. Delete Branch action
  5. Set up a Delete Branch action

As a workspace administrator, you can set up a Delete Branch action to enable deletion of branches in a list hierarchy that descend from a numbered list. You can also choose whether the action deletes all descendants, or  only the immediate children of a numbered list item.

The list hierarchy for which you want to set up a Delete Branch action must contain a numbered list that is set as the parent of another list.

You can configure a Delete Branch action to delete items from a flat list. However, if you do so, the action only deletes the item or items the user selects in that list.

You must publish the Delete Branch action to a dashboard. This is because the user must select a parent or parents from the numbered list before they run the action. To enable this, publish the numbered list from which the user will select branches to delete, or a child list of that list.

You can publish the list to an existing dashboard or new one. After you set up the action, publish the it to the same dashboard as the list.

To set up a Delete Branch action:

  1. In the Actions tab of the Actions pane, select New Action from the toolbar at the top. 
  2. Select Delete Branch from the menu.
  3. Enter the button name in the Button text field.
    Follow best practice naming conventions to ensure the action is easy to identify.
  4. In the Delete from dropdown, select the list from which you want to select a branch to delete.
    Only numbered lists are available to select.
  5. In the Level to delete dropdown, select:
    • All levels to delete the item the user selects, all its descendants, and all associated data.
    • Immediate children only to delete only the item the user selects and its immediate children.
  6. Select OK.
  7. Publish the action to a dashboard