product mass action

The product mass action extension point customizes product grid mass actions in the Adobe Commerce Admin.

Example customization

The following example creates mass actions labeled First App Mass Action and Another Mass Action. The extensionId value matches the ID specified at app registration.

The path parameter specifies where to redirect an action. The Admin UI SDK provides the selected product IDs in a sharedContext when a merchant selects a mass action. Your implementation must read the selected items from the sharedContext.

product: {
    getMassActions() {
        return [
            {
                actionId: `${extensionId}::first-mass-action`,
                label: 'First App Mass Action',
                confirm: {
                    title: 'First App Mass Action',
                    message: 'Are you sure your want to proceed with First App Mass Action on selected products?'
                },
                path: '#/first-mass-action',
                productSelectLimit: 1
            },
            {
                actionId: `${extensionId}::another-first-mass-action`,
                label: 'Another Mass Action',
                title: 'Another Products Mass Action',
                path: '#/another-mass-action'
            },
            {
              actionId: `${extensionId}::update-mass-action`,
              label: 'Update Mass Action',
              path: 'api/v1/web/SampleExtension/update-products',
              displayIframe: false,
              timeout: 15
            }
        ]
    }
}
Copied to your clipboard
product: {
    getMassActions() {
        return [
            {
                actionId: `${extensionId}::first-mass-action`,
                label: 'First App Mass Action',
                confirm: {
                    title: 'First App Mass Action',
                    message: 'Are you sure your want to proceed with First App Mass Action on selected products?'
                },
                path: '#/first-mass-action',
                productSelectLimit: 1
            },
            {
                actionId: `${extensionId}::another-first-mass-action`,
                label: 'Another Mass Action',
                title: 'Another Products Mass Action',
                path: '#/another-mass-action'
            },
            {
              actionId: `${extensionId}::update-mass-action`,
              label: 'Update Mass Action',
              path: 'api/v1/web/SampleExtension/update-products',
              displayIframe: false,
              timeout: 15
            }
        ]
    }
}

Parameters

Field	Type	Required	Description
`actionId`	string	Yes	A unique ID assigned to the action. The recommended format is `<extensionId>::<actionName>`
`confirm.message`	string	No	The message displayed on the confirmation dialog for a mass action
`confirm.title`	string	No	The title of a dialog that confirms the mass action
`label`	string	Yes	An Action label to display in the Mass Actions grid
`title`	string	No	An optional page title for the action. If not specified, the label is used.
`path`	string	Yes	The relative path in the application to redirect to the action. You might need to prepend `#/` to the path to ensure access to the correct page.
`productSelectLimit`	integer	No	Set the maximum number products that can be selected for a mass action. By default, the number is unlimited.
`displayIframe`	boolean	No	Indicates whether an iFrame will be displayed at the relative path. The default value is `true`. Mass actions without iFrames provides additional details.
`timeout`	integer	No	Only relevant when `displayIframe` is set to `false`. The number of seconds to wait for a response to a request sent to the application. Default value is 10 seconds.

Sample code

The Adobe Commerce Extensibility Code Samples repository demonstrates how to customize the product mass action.

grid columns

Admin configuration and local testing

Last updated 7/12/2024

Was this helpful?

Yes

product mass action

Example customization​.css-83mclq{margin-left:var(--spectrum-global-dimension-size-100);}

Parameters

Sample code

Example customization