WordPress Image SEO: How to Write Better Alt Text, Filenames, and Captions

Images do more than make a WordPress article look less like a tax form. They explain ideas, demonstrate steps, show products, and help readers decide whether a page answers their question. They can also help people discover your content through Google Images.

But uploading a photograph and hoping search engines figure everything out is not an image SEO strategy. Each image needs the right context: a useful filename, appropriate alternative text, relevant surrounding copy, and a file that balances visual quality with page performance.

Google says it uses alt text, page content, and computer vision to understand images. The World Wide Web Consortium (W3C) explains that text alternatives must reflect an image's purpose, not merely list what it looks like. Those two principles make a good starting point for WordPress image SEO.

What Is Image SEO?

Image SEO is the practice of making images easier for search engines to discover and understand while keeping them useful and accessible to people. For a WordPress site, it typically involves choosing an appropriate image, using a descriptive filename, writing useful alt text, adding captions when helpful, choosing sensible dimensions and formats, and placing images near relevant content.

No single field guarantees rankings. A descriptive filename cannot rescue an irrelevant image, and perfect alt text cannot make a page useful if the page itself does not answer the visitor's question.

For Google's primary guidance, see Google Search Central's image SEO best practices.

Alt Text, Image Title, Caption, and Filename: What's the Difference?

WordPress exposes several image fields, and they are not interchangeable.

Alt text is not a place to dump keywords. It is a text alternative. A caption is visible to readers and can add information that does not belong in the alt text. A filename is useful metadata, but it is only one small signal.

WordPress explains the image fields in its Media Library documentation.

How to Write Useful Alt Text in WordPress

Alt text should communicate the information or function an image contributes to the page. It should not describe every visual detail regardless of relevance, and it should not repeat the target keyword mechanically.

1. Identify why the image is there

Before writing alt text, ask what the image does in that article.

• Informative image: Describe the essential information conveyed by the photo, diagram, or screenshot.
• Decorative image: Use an empty alt attribute (alt="") when the image is purely visual and adds no meaningful information.
• Functional image: If the image is the only content in a link or button, describe the action or destination.
• Chart or complex diagram: Give a concise alternative to the main message and include fuller data or explanation in nearby text when needed.

These distinctions follow the W3C's Images Tutorial. Context matters: a bird photo on a general travel blog may need a simple description, while a bird-identification article may need to distinguish the species.

2. Describe the meaningful subject

Imagine a reader cannot see the image. What information would they need to understand the article?

For a travel guide, Arashiyama Bamboo Grove in Kyoto may be enough for a representative landscape photograph. If the point is crowd levels, Visitors walking through the crowded bamboo path at Arashiyama is more informative.

For a WordPress tutorial, a screenshot may need alt text such as WordPress Media Library showing the Alt Text field for an image. That is more useful than WordPress screenshot.

3. Keep it concise and specific

There is no universal character count that makes alt text correct. Write enough to convey relevant information, but do not turn the field into a paragraph of unrelated details. Avoid starting every image with “image of” unless those words genuinely help.

4. Use keywords only when they naturally describe the image

Weak:WordPress image SEO, image SEO WordPress, best WordPress SEO images, image alt text SEO

Better:WordPress Media Library showing the alternative text field for a selected image

The second example describes the actual screenshot. That is the point.

5. Check images already in published posts

In the block editor, select an Image block and enter alternative text in the block settings. You can also edit an image through Media → Library.

One important detail: updating an image's metadata in the Media Library does not necessarily update every instance already inserted into old posts. WordPress documents that image settings can be edited separately after insertion. Check existing pages after bulk or library-level changes. See the official guide to editing media information.

When Should an Image Have Empty Alt Text?

A decorative flourish, divider, or image that adds no information should generally use an empty alt attribute. This lets assistive technology skip it instead of announcing irrelevant details.

An empty alt attribute is not the same as omitting the attribute entirely. For informative images, missing alt text can cause assistive technology to fall back to a filename or URL, which is rarely helpful.

Do not label an image as decorative just because writing alt text is inconvenient. If it explains a process, identifies a product, or provides meaningful evidence, give it an appropriate alternative. The W3C provides examples in its tutorial on decorative images.

How to Name Image Files for WordPress SEO

Choose the filename before uploading the image. Renaming an image after publication may require replacing the file and updating every reference to its URL.

Google says filenames provide only light clues about an image's subject. Use them to make files understandable, not as a ranking shortcut.

Good habits include using a few meaningful words, separating words with hyphens, keeping the extension consistent with the actual format, and avoiding keyword strings. Do not change the URL of an established image without a reason and a plan for updating references.

For an existing library full of inconsistent filenames, the guide to converting WordPress uploaded image filenames to lowercase covers one aspect of filename consistency. The better habit is to plan names before uploading new assets.

Do Captions Help SEO?

Captions help when they add useful context. They can identify a location, explain a screenshot, credit a photographer, or clarify a chart. They are not mandatory for every image, and repeating alt text verbatim underneath the image usually adds little value.

For example:

• Alt text:A bowl of tomato soup topped with basil and black pepper
• Caption:Roast the tomatoes first for a deeper, sweeter flavor.

The alt text describes the image; the caption adds a useful cooking note.

Google notes that it can use page text and captions to understand an image. Place images close to the text that explains them, and make sure the page's overall topic matches the image.

Choose the Right Image Format and Dimensions

Image SEO is not just metadata. Unnecessarily large images can slow a page, especially on mobile connections.

• JPEG: Often suitable for photographs.
• PNG: Useful when transparency or lossless quality is needed, though files can be large.
• WebP or AVIF: Modern formats that can offer good visual quality at smaller file sizes, depending on the image and encoder.
• SVG: Useful for vector artwork such as logos and icons, but uploaded SVG files need appropriate security handling because they can contain active content.

Support depends on WordPress version, server image libraries, and plugins. Test a representative image and verify that it renders correctly. Resize images to suit their intended placement; a small thumbnail rarely needs a 5,000-pixel source image.

The guide to serving WebP and AVIF images in WordPress covers modern image formats and existing Media Library images. For vector assets, see its guide to allowing SVG uploads in WordPress, including the security trade-offs.

Use Images You Have Permission to Publish

An image can be technically optimized and still be a bad choice if you do not have permission to use it. Use your own photos, properly licensed stock images, or media whose terms permit your intended use. Check attribution requirements, commercial-use restrictions, and any conditions involving recognizable people, logos, or trademarks.

Do not assume an image is free to reuse simply because it appears in Google Images or on social media. Search results help you find images; they do not grant a licence.

The guide to websites offering free photos compares sources and licensing considerations. Read the original licence terms for the specific image you select.

Make Sure Google Can Discover the Image

Even well-described images need to be discoverable. Google recommends standard HTML image elements because crawlers can find images through an <img> element's src attribute. Images used only as CSS backgrounds may be harder for search engines to discover as image content.

Check that:

1. The image appears in the rendered page.
2. The page and image URL can be accessed by crawlers that should see them.
3. The image is not unintentionally blocked by access controls or crawling rules.
4. The image is placed near relevant text.
5. The page title and content match the image's subject.
6. CDN image URLs remain stable and accessible.

For a site with many important images, an image sitemap can help Google discover images it might not otherwise find. WordPress sitemap plugins vary, so check the actual sitemap output. A sitemap is a discovery aid, not a guarantee of indexing or rankings.

The tutorial on generating an XML sitemap in WordPress explains sitemap creation and submission. If the whole page is slow, image optimization may be only one part of the fix. Its WordPress speed optimization guide provides a broader order of operations so you can measure the bottleneck rather than install performance plugins at random.

A Practical WordPress Image SEO Workflow

Before uploading

• Confirm you have permission to use the image.
• Crop and resize it for its intended placement.
• Choose a descriptive filename.
• Compress it while preserving important detail.

In the WordPress editor

• Add the image near the section that explains it.
• Write alt text based on its purpose.
• Use empty alt text for genuinely decorative images.
• Add a caption only when it provides useful context.
• Choose a suitable display size and check mobile layout.

Before publishing

• Preview the page at desktop and mobile widths.
• Check that the image is sharp enough and not unnecessarily large.
• Verify that alt text describes the actual image.
• Make sure the image URL works and is not blocked accidentally.
• Review the page title and nearby text for relevance.

After publishing

• Use Google Search Console to inspect important URLs when needed.
• Review image search performance where reporting supports it.
• If you replace an image, update the page and confirm the new asset is accessible.
• Avoid casually renaming or moving existing image files; old posts, caches, social shares, and external sites may still link to the original URL.

Common WordPress Image SEO Mistakes

Keyword-stuffed alt text. Describe the image's relevant information rather than listing variations of a search phrase.

The same alt text on every image. Describe each image according to its content and role on that page.

Alt text on purely decorative images. Empty alt text can be the right choice when the image adds no information or function.

Treating captions, titles, and alt text as identical fields. They have different purposes and may be used differently by themes and plugins.

Uploading huge images and relying on a plugin to fix everything. Start with suitable dimensions and file sizes, then measure the result.

Using images without checking licences. A search result is not proof of permission.

Changing published image URLs without updating references. Old URLs may appear in posts, caches, feeds, social previews, or external backlinks.

Assuming image SEO guarantees traffic. Visibility also depends on relevance, page quality, accessibility, crawling, and competition.

Frequently Asked Questions

Does alt text improve WordPress SEO?

Alt text helps search engines understand an image and provides a text alternative for people who cannot see it. It is one part of image SEO, not a guarantee of higher rankings. Write accurate, contextual descriptions rather than stuffing keywords into the field.

How long should alt text be?

There is no universal character limit that makes alt text correct. Keep it concise while conveying relevant information or function. Complex diagrams may need a short alternative plus a fuller explanation in nearby text.

Should decorative images have alt text?

Decorative images that add no meaningful information should generally use an empty alt attribute (alt=""). This allows assistive technology to skip them. Informative and linked images need alternatives that communicate their content or function.

Do image filenames matter for Google Images?

Yes, but Google describes filenames as providing light clues about an image's subject. Use short, descriptive filenames instead of generic camera names, while prioritizing relevant imagery, useful alt text, page context, and accessibility.

Should I add captions to every WordPress image?

No. Add captions when they provide useful context, such as a location, source credit, explanation, or detail that helps the reader. Avoid repeating the alt text verbatim unless the same wording genuinely serves both purposes.

Which image format is best for WordPress SEO?

There is no single best format for every image. WebP and AVIF can reduce file size while maintaining quality, JPEG is useful for many photographs, PNG can suit transparency or lossless needs, and SVG can work for vector graphics when handled securely. Test format support on your hosting setup.

Official References

• Google Search Central: Google Images SEO Best Practices
• W3C Web Accessibility Initiative: Images Tutorial
• W3C WAI: Decorative Images
• WordPress Documentation: Media Library Screen
• WordPress Documentation: Edit Media