Mass Product Actions

Mass Product Actions adds fifteen extra mass actions to the Catalog > Products grid in the Magento admin. Each run is a job with a log, per-product messages and, for most actions, undo. This guide covers installation, the settings, every action, the job log, permissions and the command line.

• Admin demo: https://demo.softawarecommerce.com/try-admin/mass-product-actions
• Changelog: Release notes · Questions: FAQ

1. Requirements

2. Installation

Install with Composer. The access keys come from your account; see https://softawarecommerce.com/shop/composer-access/ for the details.

composer config repositories.softaware composer https://repo.softawarecommerce.com
composer config --auth http-basic.repo.softawarecommerce.com PUBLIC_KEY PRIVATE_KEY
composer require softaware/module-mass-product-actions
bin/magento setup:upgrade
bin/magento setup:di:compile            # production mode only
bin/magento setup:static-content:deploy # production mode only
bin/magento cache:flush

Make sure Magento's cron is running (bin/magento cron:install): larger selections are processed by cron. To update later, run composer update softaware/module-mass-product-actions and the same bin/magento commands.

3. Settings

Stores > Configuration > Softaware > Mass Product Actions (also under Softaware > Mass Product Actions > Settings). All settings are global.

4. Running an action

1. Go to Catalog > Products (or Softaware > Mass Product Actions > Run on Products).
2. Filter the grid and tick the products you want to change.
3. Open Actions > More actions and choose an action.
4. Fill in the form. For price, special price, cost and text, press Preview to check the new values first.
5. Press Apply. A message tells you how many products were updated, skipped or failed and links to the job.

Each form shows whether the action can be undone. Products the action does not apply to (for example the price of a configurable product) are skipped with a reason instead of failing the job.

5. The actions

Update price, Update cost

Change: Set to, Increase by amount, Decrease by amount, Increase by %, Decrease by %. Rounding: no rounding (2 decimals), or round to the nearest ending, up to an ending or down to an ending, with the endings .99, .95, .90, .50, .49 and .00. Configurable products and bundles with dynamic prices are skipped, as their prices come from their variants or items. Amounts and results are checked (up to 999,999,999,999.99, never negative).

Update special price

Set the special price as a % below the price, an amount below the price, a fixed special price, or remove the special price. Dates: keep the current dates, set a from and to date, or clear them.

Add, remove or replace categories

Add the products to the chosen categories (existing ones are kept), remove them from the chosen categories, or replace all categories. "Replace" with no category chosen removes all categories. Each product is saved in full, so URL rewrites and category indexes are updated as when you edit a product. Undo restores the categories and their positions.

Add to or remove from websites

Uses Magento's own website assignment, including URL rewrites. A product removed from all websites is no longer sold anywhere.

Change status, Change visibility

Enabled or Disabled, and the visibility options, for all store views or one store view. Status has website scope in Magento, so a store-view change applies to all store views of that website. Optionally remove values set on individual store views so the new value applies everywhere.

Update stock

Quantity: keep, set to, increase by or decrease by. Stock status: keep, in stock or out of stock. This changes the default stock. Magento sets products with "Manage Stock" and no quantity left to out of stock automatically.

Assign attribute value

Choose any editable product attribute (a filter box helps with long lists) and enter the value. Text, text area, select, multiselect, number, date and yes/no attributes are supported. Multiselect values can replace, add to or remove from the current options. Remove the value empties it, or on a store view goes back to the default value. Choose the store view in Scope; global attributes always apply to all store views. Products whose attribute set does not contain the attribute are skipped. SKU, URL key, images and other attributes Magento manages itself are not offered.

Change attribute set

Moves the products to a new attribute set, with safety checks: configurable products and their variants are skipped if the new set lacks any of their configurable attributes, and products are skipped if a required attribute of the new set has no value. Values of attributes that are not in the new set stay in the database but are no longer shown or used.

Related, up-sell and cross-sell links

Choose the link type, then: link the selected products to each other (up to 200 products), link the selected products to these SKUs (optionally in both directions), remove links to these SKUs, or remove all links of this type. Enter SKUs one per line or separated by commas.

Copy custom options from a product

Enter the SKU to copy from, then keep the existing options and add the copied ones (options with the same title are not added twice), or delete the existing options and use only the copied ones. Grouped products are skipped. Cannot be undone.

Copy images from a product

Enter the SKU to copy from, then keep the existing images and add the copied ones, or use only the copied images, optionally with the source's image roles. The image files are copied, so every product keeps its own files. Cannot be undone.

Duplicate products

Uses Magento's "Save & Duplicate": 1 to 5 copies per product, an optional text added to the name (for example " (copy)"), and optionally enable the copies (copies are disabled by default). The new SKUs are listed in the job log. Cannot be undone. Duplicating needs Magento's admin configuration, so cron does not run it: large duplicate jobs run from the open job page in the admin or with softaware:mass-actions:process.

Append or replace text

Fields: name, description, short description, meta title, meta keywords and meta description. Append text at the end, Add text at the start, or Find and replace (with Match case). Spaces are kept, so start with a space to append " Sale" to "Blue Shirt". Leave the text empty with "Find and replace" to delete the found text. A name can never be emptied.

6. Job log and undo

Softaware > Mass Product Actions > Job Log lists every run: ID, created, admin user, mass action, summary, status, processed, updated, skipped and failed counts. Open a job with View.

The job page shows the progress (live for queued jobs), the details, the per-product messages (skipped products and errors with their SKU) and, under Technical details, the parameters. From there you can:

• Cancel Job: stops a queued or running job before its next batch. Products already processed keep their changes.
• Undo Job: restores the values from before the job, as a new job. The page lists later jobs (not undone) that changed the same fields of the same products, and the confirmation names them, because undo overwrites those later changes. Undo jobs in reverse order.

Undo is available for update price, special price and cost, categories, websites, status, visibility, stock, attribute value, attribute set, links and text. It is not available for copying custom options, copying images and duplicating.

7. How processing works

• Every run is stored as a job. Small selections are processed during the request; larger ones are queued.
• The cron job softaware_mass_product_actions_process runs every minute in its own cron group (softaware_mass_product_actions), which Magento runs as a separate process, so a long queue does not delay other cron jobs. Each run processes batches until the time budget is used.
• Progress is saved after each batch, so an interrupted job continues where it stopped.
• Attribute changes use Magento's Product\Action::updateAttributes(), with the same events and plugins as the native "Update attributes". Categories, attribute set, options, images and duplicates save each product in full.
• Afterwards the price, EAV, category, stock, flat, search and catalogue rule indexers are run for the changed products (or left to Magento when they are "Update by Schedule"), and the page cache is cleaned for those products.
• A daily cron job deletes finished jobs older than Keep Finished Jobs For (Days).

8. Permissions (ACL)

Under System > Permissions > User Roles > Role Resources > Softaware > Mass Product Actions:

Assign attribute value also requires the matching price permission for price, special price and cost (Update Price, Update Special Price, Update Cost), and Magento's "Edit Product Design" permission for design attributes such as the page layout and custom design.

9. Command line

bin/magento softaware:mass-actions:process [--job=ID] [--time=3600]   # process queued jobs now
bin/magento softaware:mass-actions:jobs [--limit=20] [--status=pending|running|complete|complete_errors|failed|cancelled]

process is useful for large duplicate jobs, or to run a big queue without waiting for cron.

10. Troubleshooting

11. Limitations

• Default stock only: no per-source quantities with Multi-Source Inventory.
• Adobe Commerce content staging is not supported.
• Copying custom options or images and duplicating cannot be undone.
• Undo data is written after each batch. If PHP stops in the middle of a batch, that batch runs again when the job resumes, and its undo data then holds the values already changed in that batch.

12. Uninstall

bin/magento module:disable Softaware_MassProductActions
composer remove softaware/module-mass-product-actions
bin/magento setup:upgrade

Product changes made with the module stay.