The filename identifies the asset
Think of the filename as a label for the file in your publishing workflow. It should distinguish the image from other assets without requiring a full sentence. A product name and a view are often enough.
The extension describes the actual format. Keep it consistent with the exported file, and maintain a record of the old name if other people still work with the source collection.
Alt text depends on placement
Alternative text communicates an image’s information or function when it cannot be seen. The same photo can need different wording in a product listing and in a detailed guide because the reason for including it has changed.
A generated image title is an editorial suggestion. It is not the page’s SEO title, and entering text in a media-library title field does not guarantee that the theme will use it as accessible alternative text. Check the published markup.
Captions add visible context
Use a caption for information you want everyone to read near the image: a location, date, attribution, explanation, or observation. A caption can discuss the significance of a photograph while the alt text describes the relevant visible content.
When transferring PixelRank’s CSV into your website, map each column deliberately. Do a one-image trial before a bulk import. Verify the filename, alt attribute, visible caption, and any displayed title separately so an import mismatch does not spread across the library.
A practical comparison
- Before
- One phrase pasted into every image field
- Better approach
- Filename: oak-desk-drawer-detail.jpg · Alt: Open drawer showing the desk’s interior compartments
A caption could explain the organization options if that information belongs in the visible page copy.
Illustrative example, not a customer result.Further reading
For platform guidance, consult Google’s image SEO documentation and the W3C image accessibility tutorials. These guides combine editorial workflows with the product’s current capabilities; search visibility depends on more than image metadata.
Put the workflow to use
Draft descriptive filenames and alt text, review the results, and export your image metadata. Start with 10 images per month on Free.
Optimize your first imageCompare plans