# How to bulk edit product descriptions in Shopify

Updated 9 Nov 2026 · 8 min read · https://apimate.chat/blog/shopify-bulk-edit-descriptions

Yes, in two free ways. The admin bulk editor has a Description column: each cell opens a rich-text editor for that one product, with no find and replace across rows. For one change across many products, use a CSV: export the products, edit the Description column (it holds HTML), and import the file with "Overwrite products with matching handles" turned on. The [four ways to bulk edit Shopify products](/blog/bulk-edit-shopify-products) compares it with the other methods field by field.

The CSV is fine for one identical change: the same sentence removed, the same warranty line added. It is weak at text that has to differ per product, because the spreadsheet has no idea what each product is, and it is risky at scale, because a blank Description cell with overwrite on blanks the description in your store.

So the method follows the job. This page takes the three jobs in turn, append, replace and rewrite, and for the rewrite it covers ApiMate, which writes a different text per product from that product's own data and shows every row before writing. The free plan covers a small job, and the [SEO titles and meta descriptions case](/cases/shopify-bulk-edit-seo) shows a real run.

## Three kinds of description edit

Most "bulk edit descriptions" requests are one of three jobs, and the right method depends on which. An append or prepend adds the same care instructions or warranty line to every product in a collection. A find and replace removes "Free shipping until Friday" from every description or swaps an old brand name for a new one. A rewrite gives each product a different description, written from that product's facts.

The first two are the same text on every row. Any method that can apply one rule to many rows can do them. The third is a different text on every row, and that is where CSV and most apps stop being useful, because somebody has to produce the text first.

| Job | Admin | CSV | App | ApiMate |
| --- | --- | --- | --- | --- |
| Add the same line to a collection | Per product | Formula, paste as values | Append action | One sentence, no credits |
| Remove one sentence everywhere | Per product | Replace in the sheet | Find and replace action | One sentence, no credits |
| A different text per product | Per product, by hand | Only if the texts exist | Templates, some AI | Generated per row, two approvals |
| Get the old text back | No history | Your pre-edit export | Backup window by plan | Revert from history |

_The first two jobs are the same text on every row. Only the third needs something to write the text._

## Append the same block to every product

This is a CSV job. Products, Export, edit, Products, Import. The description is in the column named Description, and it holds HTML: paragraphs are <p> tags, lists are <ul> and <li>. Older exports call it Body (HTML); Shopify says it keeps backward compatibility with older column names, so either header imports.

For updates, the only required columns are URL handle and Title. Delete every column except URL handle, Title and Description, then add the block with a formula that joins the existing cell and the new HTML, and paste the result as values. Import with "Overwrite products with matching handles" on. Without that option, products whose handle already exists are ignored, so nothing changes and the import still looks successful.

Bulk-edit apps (Matrixify, Ablestar, Hextom and others) do the same with an append or prepend action on a filter: a collection, a vendor, a tag. Most show the target count before running and keep a backup window for undo. In ApiMate, "Add the line '2-year warranty' to every description in Outdoor" is written as you typed it and costs no generation credits.

Sources: [Shopify Help: using CSV files for products](https://help.shopify.com/en/manual/products/import-export/using-csv)

## Find and replace a phrase

In the CSV, use the spreadsheet's replace on the Description column only, and check the count it reports. If it is bigger than the number of products you expected, the phrase also appears somewhere you did not mean to touch.

Replace whole sentences or whole tags. A replace that removes "<p>Free shipping" but leaves the closing "</p>" imports fine and leaves stray markup that some themes render as an empty paragraph.

Apps offer find and replace as an action on the description field. In ApiMate the new text is computed from each row's current description, with no AI generation: "Remove the sentence 'Free shipping until Friday' from every product description." The preview lists each product that contains the sentence, with the description before and after.

## Rewrite each one

In the admin, one product at a time: open the product, edit the Description field, save. The editor shows formatted text, and the "Show HTML" view shows the markup that is actually stored. The bulk editor does the same in a grid: open "Columns", tick Description, click a cell, and the same editor opens for that product. It saves the clicks between products, not the typing.

A CSV moves text; it does not write it. The new descriptions have to exist before the import. An app template such as "{title} by {vendor}" fills in fields, which is not a description. Some apps have added AI writing; check what context the app gives the model and whether you see the text before it is saved.

In ApiMate, the text is generated per row inside the job from each product's title, vendor, type, tags and current description, in batches. You approve twice: first the generation itself, with the credit estimate and a few real samples, then the finished texts, row by row. Nothing is written to Shopify until the second approval. A text over the length you set is excluded and stays visible as excluded, not cut off; texts that repeat each other with one word swapped fail a near-duplicate check. The previous descriptions are saved at write time, and a revert writes them back without spending generation credits.

> **Instruction** Rewrite the descriptions of every product in the Outdoor collection: two short paragraphs from the existing description, keep the materials and sizes, no claims that are not already there.

- Give it facts. A description generated from the title alone invents specifications, and invented specifications on 1,400 products is a support problem.
- Name the scope. "Active products in Outdoor" and "all products" are different counts; read the count first.
- Run it on ten, read all ten in full, then widen the scope.

Sources: [Shopify Help: bulk editing](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/bulk-editing)

![Shopify bulk editor Description cell open in a rich-text editor for one product, with headings and a table](https://apimate.chat/shopify-admin/bulk-editor-description-cell.webp)

_The Description column in Shopify's bulk editor. A cell opens the same editor as the product page, one product at a time. apimate-dev test store, November 2026._

## What breaks HTML in a spreadsheet

Descriptions are HTML with commas, quotes and line breaks inside, which is the hardest kind of cell a spreadsheet has to carry. Most failures come from the file, not from Shopify.

- Blank cells with overwrite on. A column you removed keeps its value; a column you kept and left blank is written as blank. A failed formula or a truncated row empties that product's description. Filter for blanks before importing. The same rule empties [image alt text](/blog/shopify-bulk-edit-alt-text).
- Rewritten quotes. Some tools change straight quotes or split cells at line breaks. Save as UTF-8, which is what Shopify asks for, and open the file in a text editor once if the import reports more rows than you have products.
- Half-removed tags. A dangling </p> or </li> survives the import and shows up as empty space on the page.
- The search snippet. Shopify uses the product description when the SEO description is blank, so a description edit changes the snippet of those products too.
- No copy of the old text. With CSV and the admin, your pre-edit export is the only way back; [how to undo a bulk edit in Shopify](/blog/how-to-undo-bulk-edits-in-shopify) lists what else can restore it.

## Terms used on this page

- Description: the product body text, stored as HTML. The CSV column is Description; older files call it Body (HTML).
- Overwrite products with matching handles: the import option that updates existing products. Without it, rows with an existing handle are skipped.
- Find and replace: the same change computed from each row's current text. No writing involved.
- Generation: a model writing a different text per row from that row's data.
- Near-duplicate: two generated texts that differ by a word or two. A catalog full of them reads as copied.

## Questions

### Can you bulk edit descriptions on Shopify?

Yes, with a CSV: export, edit the Description column, import with "Overwrite products with matching handles" on. Apps and chat tools such as ApiMate do it without a file.

### Does the Shopify bulk editor edit descriptions?

Yes. In the bulk editor, open "Columns" and tick Description. Each cell opens a rich-text editor with an HTML view, one product at a time. There is no find and replace across rows; for one change on many products, use a CSV or an app.

### What is the description column called in the Shopify CSV?

Description, and it holds HTML. Older exports call it Body (HTML); Shopify keeps backward compatibility with older column names.

### Will a CSV import erase my other fields?

A column you remove from the file keeps its value. A column you keep and leave blank is overwritten as blank when the overwrite option is on. Import only URL handle, Title and Description.

### Can I remove one sentence from every description?

Yes. In a CSV, replace it in the Description column. In ApiMate, say which sentence; the change is computed from each description and costs no generation credits.

### How do I undo a description change?

With CSV, re-import the export you made before. With an app, its backup window. ApiMate saves each previous description and reverts the job from history.

## Related

- [How to bulk edit Shopify products](https://apimate.chat/blog/bulk-edit-shopify-products): Admin, CSV, apps and chat: which fields each one reaches.
- [Bulk edit SEO titles, meta descriptions and alt text](https://apimate.chat/cases/shopify-bulk-edit-seo): A real run: per-row SEO text, previewed and approved.
- [How to bulk edit image alt text in Shopify](https://apimate.chat/blog/shopify-bulk-edit-alt-text): The CSV column, its limits, and per-image text.
- [How to undo a bulk edit in Shopify](https://apimate.chat/blog/how-to-undo-bulk-edits-in-shopify): What each method gives you after a bad write.
