Bulk record actions are rendered when multiple record rows are selected in Attio. Any file with a named export of bulkRecordAction will register a record action

Arguments

id
string
required
The unique identifier for this action.It is only used internally; never shown to the user.
label
string
required
The human readable label for the record action.
icon
AttioIcon | string
An icon to display in the action, either an AttioIcon or a string .png referencing a file in your app’s assets directory.
If no icon prop is provided, it will default to your app’s icon that you set up in the Developer dashboard.
onTrigger
async ({ recordIds: string }) => Promise<void>
The function to run when the action is triggered. You’ll likely want to show a dialog or run a server function here.
objects
ObjectSlug | Array<ObjectSlug>
A single slug or an array of slugs to select which types of record the record action will apply to.Defaults to undefined, which will cause the action to show on all types of records.The built-in slugs are

Example Usage

TypeScript
import type {BulkRecordAction} from "attio/client"

export const bulkRecordAction: BulkRecordAction = {
  id: "send-invoices",
  label: "Send Invoices",
  icon: "Sales",
  onTrigger: async ({recordIds}) => {
    // Run code here
  },
  objects: "people",
}