# bulkActionModal

**Category:** Features/Actions/Bulk Actions

## API

### Overview

`bulkActionModal` is a render-prop passed to collection components (`Table`, `Grid`, `TableFolders`, etc.) that opens a custom modal when a bulk action is triggered from the [`MultiBulkActionToolbar`](./?path=/story/features-actions-bulk-actions--multibulkactiontoolbar).

The render function receives:
- `selectedValues` — the items selected via the checkbox column
- `uncheckedValues` — the items that were unchecked (relevant when "Select All" is active)
- `isSelectAll` — whether the "Select All" checkbox is checked
- `closeModal` — closes the modal
- `query` — a [`ComputedQuery`](./?path=/story/common-types--computedquery) representing the current paging, sorting, and filtering. Useful for server-side bulk operations like `updateAll` or `deleteAll`.

Return a React element (typically a `` or custom modal content) from the render function.

### Usage

```tsx
 (
    
      
        Delete Selected
      
    
  )}
  bulkActionModal={({ selectedValues, closeModal }) => (
     { deleteItems(selectedValues); closeModal(); }}
      secondaryButtonText="Cancel"
      secondaryButtonOnClick={closeModal}
    >
      Delete {selectedValues.length} items?
    
  )}
/>
```