Skip to content

Black Friday 50% off your first year on all premium plugins and the Suite.

See the deals

ByteKeel PixTag

Protect hand-written alt text

Keep alt text your team wrote by hand. See which bulk and AI actions skip existing descriptions, which replace them on purpose, and how to test before a large run.

Protect hand-written alt text: ByteKeel PixTag label and the headline "Protect hand-written alt text" beside a close-up of wordPress Media Library list view with the ByteKeel PixTag Alt Text column showing which images have alt text

In short:

  • Fill gaps only: run bulk alt text tools on "Only images missing alt text" and hand-written descriptions are skipped.
  • Know what replaces: the Generate button on one image and the "All images, replacing existing alt text" scope do overwrite.
  • No undo: neither ByteKeel PixTag nor ByteKeel PixTag Pro keeps a copy of the old text, so back up before any replacement run.
  • Test first: write distinctive alt text on two or three images, run the default scope, and check they are untouched.

The fastest way to keep hand-written alt text safe

The fastest way is a bulk tool whose default scope only fills empty fields. Somebody on your team may have written "Showroom corner with the oak table and walnut bookshelf" because they knew why that photo mattered. A file-name rule cannot know that, and an AI description may be more generic.

We built ByteKeel PixTag at ByteKeel so automation fills gaps without erasing good work. Its Bulk Processor and Media Library bulk action skip images that already have alt text. ByteKeel PixTag Pro's automatic generation on upload and post save skips them too, through its "Skip existing alt text" setting, which is on by default.

You can check this on a private WordPress in the ByteKeel playground. If you use another tool or none, the test steps further down work the same way.

Which actions skip existing alt text, and which replace it?

Anything that runs over many images fills only empty fields unless you choose otherwise. Replacing existing alt text is a deliberate choice on one image, or a clearly labelled option for a bulk run.

Action Image already has alt text Edition
Bulk Processor, "Only images missing alt text" (the default) Left alone Free and Pro
Media Library bulk action "Generate Alt Text" Left alone (counted as skipped) Free and Pro
Automatic alt text on upload or post save Left alone ("Skip existing alt text", on by default) Pro only
ByteKeel AI suggestions in the review screen Replaced only for fields where you tick Overwrite Pro only
Bulk Processor, "All images, replacing existing alt text" Replaced after you confirm Free
Pro bulk with "Only images missing alt text" unticked Replaced after you confirm Pro
Generate button on a single image Replaced: that is what the button is for Free and Pro

How we tested the default bulk run

We tested the default bulk run on a library of nine images. Eight had no alt text: four with descriptive file names and four with camera file names. The ninth had the hand-written description "Stone ruins on a hillside under a clear sky."

WordPress Media Library before bulk processing, with eight images marked as missing alt text and one image with hand-written alt text
Before: eight of nine images were missing alt text.

We started the Bulk Processor with its default scope, then checked the Media Library again:

  • Descriptive file names: all four images received usable alt text.
  • DSC_ files: two received only "Dsc", which needed fixing by hand.
  • IMG_ files: two were reported as "Could not generate from filename" and left empty.
  • Hand-written alt text: the image was not included in the run and kept its original description.
WordPress Media Library after a ByteKeel PixTag bulk run, with descriptive file names filled, two camera file names still empty, and the hand-written alt text not overwritten
After: descriptive file names were filled, weak camera file names still need review, and the hand-written description was not replaced.

This test used version 1.0.10. Since 1.0.11, camera names such as DSC01234 no longer become alt text: the image gets a meaningful attachment title or is marked "Needs review".

How to test any bulk alt text tool before a large run

WordPress itself never overwrites alt text, so the risk comes from the tool you run. Prove its behaviour on a few images before you trust it with the whole library:

  1. Take a backup: a database backup holds every alt text field, and it is the only full undo.
  2. Mark test images: in Media › Library, write a distinctive alt text on two or three images, such as "TEST keep this text".
  3. Check the scope: before starting, confirm the run is set to images missing alt text only.
  4. Run the default: start the bulk run without changing anything else.
  5. Reopen the test images: their alt text should be exactly as you wrote it.
  6. Check a live page: view the page source of a post that uses a changed image, since the page may keep its own copy.

When replacing alt text is the right choice

Replace alt text when the existing text is the problem: just the file name ("IMG_4821"), template text such as "image" or "photo", or descriptions from an old product range. Pick the tool by how many images are affected:

  • A handful of images: open each one, use the Generate Alt Text button, then edit the result.
  • Many images in Pro: untick "Only images missing alt text", narrow the run by date, post type or post, and use Preview to see five results before anything is written.
  • Spreadsheet edits: the Pro Image Manager exports alt text to CSV, so you can correct it there and import it back.

Neither plugin keeps an automatic undo copy. The activity log records changes but cannot restore them. Before replacing descriptions across a large library, export a CSV from the Pro Image Manager or take a database backup.

Native WordPress vs ByteKeel PixTag for protecting alt text

Writing every description by hand is the safest method, but it is slow. A plugin speeds up filling gaps and needs care only when you replace text.

Criterion Manual in WordPress ByteKeel PixTag (free) ByteKeel PixTag Pro
Fill empty fields One image at a time Bulk run, no per-run or daily limit Bulk run, or automatic on upload
Hand-written text in bulk runs Never touched Skipped by the default scope Skipped by default
Preview before writing Not needed No Five-image preview
Copy of current alt text Database backup Database backup CSV export or database backup
Cost Free, but slow Free, no licence key From $29 a year

When you do not need ByteKeel PixTag Pro: you only fill empty fields and never plan a replacement run. The free plugin's default scope already protects hand-written text, and a database backup covers the rest.

Where else does alt text live?

Alt text can also live inside the page. The block editor's Image block and page builders such as Divi can store their own copy, so a Media Library change may not show on a page that already uses the image.

That works both ways: a bulk run cannot overwrite the copy in your page, but it cannot fix it either. Our doc on why Media Library alt text does not update your posts shows how to check which copy a page uses.

How to keep good alt text safe over time

Four habits keep hand-written descriptions in place:

  1. Leave the default scope on: only switch to replacing when you have a reason and a backup.
  2. Back up before replacing: export a CSV or take a database backup first.
  3. Write context, not labels: describe what the image shows that the page relies on, and skip "image of".
  4. Keep decorative images empty: dividers and background shapes need empty alt text on purpose.

To fill a backlog safely, follow how to bulk add missing alt text in WordPress and the Bulk Processor guide. For previews, CSV export and AI descriptions, see ByteKeel PixTag Pro.

Frequently asked questions

Ca ByteKeel PixTag overwrite existing alt text?

Yes, but only through an action that replaces text on purpose: the Generate button on one image or the replacing bulk scope. Default bulk and automatic settings skip images that already have alt text.

Does AI always write better alt text than a person?

No. AI can describe an image whose file name says nothing, but it may not know why the image matters on that page. Hand-written context is often the better description, which is why it should be protected.

Can I undo a bulk alt text replacement?

There is no one-click undo in ByteKeel PixTag or ByteKeel PixTag Pro. Restore from a database backup, or re-import a CSV you exported from the Pro Image Manager before the run.

Does automatic alt text on upload replace what I type?

Not by default. ByteKeel PixTag Pro's "Skip existing alt text" setting is on out of the box, so images that already have alt text are left alone.

  • How to bulk add missing alt text in WordPress: ByteKeel PixTag label and the headline "Bulk add missing alt text" beside a close-up of ByteKeel PixTag Bulk Processor results listing image filenames, generated alt text and a file that could not produce useful alt text

    ByteKeel PixTag · 4 Nov 2026 · 7 min read

    How to bulk add missing alt text in WordPress

    Find every WordPress image with missing alt text and fill the empty fields in bulk, from file names or AI, without overwriting descriptions your team already wrote.

Leave a Reply

Your email address will not be published. Required fields are marked *