Fix common ByteKeel PixTag problems
Alt text not generated, settings that will not save, empty results from camera file names and other ByteKeel PixTag problems, with fixes.
New uploads get no alt text
- That is expected in ByteKeel PixTag 1.0.6 and later: automatic alt text on upload is part of ByteKeel PixTag Pro. Generate it from Media › Library (bulk action or the Generate button) or ByteKeel PixTag › Bulk Processor.
- Check the file name:
IMG_4021.jpgbecomes empty once numbers and the word “img” are removed. Look under Recent Activity on the Dashboard for “failed”. Rename files descriptively, or use a template. - Only images are handled. PDFs, videos and SVG files that WordPress does not process as images are skipped.
- If the image already had alt text when it arrived, ByteKeel PixTag leaves it alone by design.
Settings are not saved
ByteKeel PixTag keeps a value it cannot accept and saves the rest. Character Limit must be between 1 and 500, and Batch Size must be between 1 and 100. An empty template becomes %filename%. If WordPress says “The link you followed has expired”, the page was open too long: reload it and save again.
Start Processing on the Bulk Processor
Keep the tab open while it runs: the processing is driven by your browser. If it stops, select Resume, or Start again once a run has finished. A run handles every matching image; there is no daily limit. See Bulk Processor and Media Library tools.
I changed alt text but my post still shows the old one
Images inserted with the block editor or classic editor keep a copy of the alt text inside the post. Changing the Media Library afterwards does not update those copies. The guide Why Media Library alt text does not update your posts explains which images update and how to fix the rest.
Template variables come out empty
Post variables only work for images attached to a post — uploaded while editing it. Images picked from the library are not attached. See Which post counts.
The image title changed too
ByteKeel PixTag saves the generated text as both alt text and image title. The title is not shown to visitors in most themes.
ByteKeel PixTag asks you to activate it
You have an older bytekeel.com copy (1.0.10 or earlier) that still asks for a key. Install the current version, which needs no licence key: see No licence key needed.
ByteKeel PixTag does not load at all
A red notice saying ByteKeel PixTag requires WordPress 6.0 or PHP 7.4 means the site is older than that. Update WordPress, or ask your host to switch PHP to 7.4 or newer (8.1 or later is better).
Frequently asked questions
Does ByteKeel PixTag send my images anywhere?
No. It only reads the file name and post data already in your database.
Will ByteKeel PixTag overwrite alt text I wrote myself?
Not with the Media Library bulk action or the Bulk Processor’s default scope — both skip images that already have alt text. The ⚡ button and the Generate Alt Text button on a single image do replace it, because you asked for it.
Does ByteKeel PixTag change the alt text inside posts I have already published?
No. It writes to the Media Library. Featured images, WooCommerce product images and other images your theme prints from the library pick it up straight away; images already inserted in post content keep their own copy.
Can I use ByteKeel PixTag and ByteKeel PixTag Pro together?
Not at the same time: with an active licence ByteKeel PixTag Pro includes everything ByteKeel PixTag does. ByteKeel PixTag Pro copies ByteKeel PixTag’s settings (once, onto untouched ByteKeel PixTag Pro settings) and, while its licence is active, turns ByteKeel PixTag off, so only one plugin runs. Without an active licence ByteKeel PixTag Pro’s features are locked until you activate or renew, and the free ByteKeel PixTag can run instead, with no limits (if it was turned off, switch it back on from ByteKeel PixTag Pro’s licence notice).
What happens when I delete ByteKeel PixTag?
By default nothing but the plugin files: its settings and activity log stay, so a reinstall picks up where you left off. To remove them too, turn on Delete data on uninstall under Settings › Advanced before deleting the plugin. Alt text it has already written always stays on your images.
Does it work with WooCommerce and page builders?
Yes. ByteKeel PixTag works on the Media Library, so any theme, builder or shop that reads alt text from the library uses what ByteKeel PixTag writes.
Did this answer the question? No — open a support request