WordPress Media Library SEO: Alt Text and Fields

Every image in the WordPress Media Library carries four text fields, and sites that do not know what each one does either leave them all empty or paste one sentence into all four. Short answer: alt text is the field that describes the image, and Google's image documentation calls it the most important metadata you can supply for an image. Title, caption and description surface in other places depending on your theme and plugins. If you run a shop journal, a portfolio or a blog with years of uploads, the order of work matters more than filling every box.

Which field does what

The WordPress documentation page for the Media Library screen (Opens in a new tab) lists the attributes shown for an uploaded file. For images the editable ones are "Alt Text", "Title", "Caption" and "Description". "File URL" is a read-only display of the direct link. If your dashboard runs in Turkish or another language, the labels may look different.

The page is explicit about one condition and silent about another. The title shows on attachment pages and in galleries only if the theme or a plugin is built to show it. For the description field the page gives no display location at all. Do not assign meaning to a field that the documentation leaves open; instead upload a test image with a unique word in each field and see which words appear on your own front end.

The rest of the Attachment Details dialog

Beyond the four text fields, the dialog lists upload date, the author who uploaded the file, the post or page it was uploaded to, the file name, the MIME type, the file size and, for images, the dimensions. Two row actions deserve a mention. "Copy URL to clipboard" puts the absolute file address on your clipboard, and "Download file" fetches the original file. Changes made in the grid-view dialog are saved automatically, so there is no save button to forget.

Writing alt text that holds up

Google's image SEO best practices (Opens in a new tab) page opens its metadata section with the statement that the most important attribute for providing more metadata about an image is the alt text. It adds that alt text helps accessibility and that, when an image is a link, its alt text works like the anchor text of a text link. The page also warns against stuffing the alt attribute with keywords, because that creates a negative user experience and may cause the site to be seen as spam.

The three-rung ladder from Google's example

The page illustrates quality with a ladder. No alt text is the weakest case. A single word such as "puppy" is better. A descriptive sentence such as "Dalmatian puppy playing fetch" is best. Translate that into your own library: an empty field is a gap, a single noun is a start, and a sentence that says what the picture shows is the target.

Linked images get extra care

If an image sits inside a link, the alt text must tell a reader or a crawler where the link goes, because the documentation says it works like anchor text. A row of small image links in a footer, each with an empty alt attribute, leaves every link without a name. Check these first when you audit a theme.

On length

The Google page sets no character limit for alt text, and the WordPress page sets none either; there is no stated limit in either document. Judge by function. If one sentence tells the reader what the picture contributes, you are done. If the picture is a complex diagram, put the explanation in the surrounding text and keep the alt text short, because the same Google page asks you to place images near relevant text.

Title, caption and description in practice

The Google page says it learns about an image's subject from the content of the page, including captions and image titles. That statement refers to what appears on the page. It does not map onto WordPress field names, and it does not promise that filling the "Title" or "Description" field of the media record will change anything. Whether a field ends up in the HTML depends on your theme, your block settings and your plugins.

File names before upload

Google asks for file names that are short but descriptive and gives the pair "my-new-black-kitten.jpg" against "IMG00023.JPG". It asks you to avoid generic names such as image1.jpg, pic.gif or 1.jpg where possible. In WordPress the name is decided before the upload. Renaming a file afterwards can break the places that reference it, so name the file at your desk, then upload.

What Google does with an image on your page

Alt text only matters if the image can be found. The same Google page lists the supported formats: BMP, GIF, JPEG, PNG, WebP, SVG and AVIF. It says standard HTML image elements help crawlers find images, that Google parses the src attribute of an img element, and that images added through CSS are not indexed. It also notes that responsive images use the picture element or the srcset attribute, and recommends always providing a fallback address in src.

The page also says that the image property in structured data is a required field for a badge and rich result in Google Images. The documentation does not explain how to add it in WordPress, so check what your SEO plugin offers. For the wider picture, see Image SEO: optimize images for Google; for images that load while scrolling, see lazy loading and SEO. The relationship between alt text and licensed pictures is covered in article image alt text and stock image licensing. Google's documentation can change; open the current page before you apply any threshold or list from it.

Attachment pages: what the documentation does and does not say

The Media Library page describes "View attachment page" as showing the media in a simulated view of how it would look in your theme. So a file can have a page of its own. The documentation does not say whether that page should be indexed, redirected or set to noindex. The documents say nothing on that point, and a rule presented as official would be invented.

Practical suggestion: look at what one attachment page on your own theme actually contains. If it shows only a large copy of the picture and a title, ask whether a reader would ever want to land there. If it shows a useful caption and a link back to the post, the answer may differ. Make the decision per site, write it down, and revisit it after a theme change.

Auditing the library you already have

List view shows media newest first, in columns for selection, thumbnail, file, author, "Uploaded to", comments and date. The File, Author, "Uploaded to" and Date headings can be clicked to sort. "Screen Options" decides which columns are visible and how many items appear per page. The search box returns media that match the words you enter.

Deleting safely

The only bulk action the page allows is "Delete Permanently", and it is permanent. "Unattached" is a hint, not proof: a picture can be used in a widget, a theme setting or a page-builder layout and still show as unattached. Before you delete, open the live pages and the theme options. Practical suggestion: delete a handful first, wait a few days, and only then continue.

Grid view and infinite scrolling

The grid view loads items as you scroll. According to the page, since version 7.1 that is the default, and a user can switch it off for their own account with the checkbox "Disable infinite scrolling in the Media Library grid view" on the profile screen; the option is only shown to users who can upload files. The page was last updated on 2026-10-22, so check the current text before you rely on this detail. For an audit, list view with sorted columns keeps your place better than a long scroll.

A workflow for new uploads

Cleaning an old library is wasted if new uploads repeat the same gaps. Build a short routine into publishing.

1. Name the file before it goes in.
2. Write alt text in the upload dialog, not later.
3. Mark decorative images with an empty alt attribute.
4. Check the published page, not only the editor.

A five-minute check of one published page

The media record is only half the picture, because what reaches the visitor is the HTML your theme prints. Open one published post in a private window and view the page source. Search for the img elements and read three things on each: the src attribute, the alt attribute and the surrounding text.

Practical suggestion: repeat the check after a theme or page-builder update, because a new template can change which fields it prints without touching your media records.

A short alt text style guide for a team

When several people upload, a shared rule set keeps the library consistent. The seven rules in this style guide follow the examples in Google's image documentation and are a practical suggestion, not a requirement of either document.

1. Describe what the picture shows in one sentence, as if you were telling someone on the phone.
2. Skip phrases such as "image of" or "picture of"; the reader already knows it is an image.
3. Name the product, place or action that the nearby paragraph discusses.
4. Use a keyword only when it is a natural part of the description.
5. For linked images, say where the link leads.
6. For decorative images, leave the alt attribute empty.
7. For screenshots, state the setting or result the reader needs to see.

The guide fits on one page. Practical suggestion: keep it that short, so that filling alt text at upload stays the rule people remember.

Example scenario: a hand-woven rug workshop's journal

Example scenario: a hand-woven rug workshop keeps a journal with dyeing diaries, wool tests and workshop announcements. Three years of uploads sit in the library with camera file names, empty alt fields and a handful of test files nobody remembers.

1. The owner opens list view and sorts by "Uploaded to" to see which journal entries carry the most pictures.
2. She starts with the three entries that bring the most readers and writes an alt sentence for every dye test photo, naming the dye and what the swatch shows.
3. The thin decorative line under each heading gets an empty alt attribute.
4. She filters "Unattached", opens the live site and the theme options to check each file, and deletes only the ones she can prove are unused.
5. She uploads a test image with a distinct word in the title, caption and description fields and learns that her theme prints the caption but not the description.
6. She opens one attachment page and decides to revisit the question after the next theme update, since the documents give no rule.

The scenario shows an order that works for any size of site: informative images on high-traffic pages first, then housekeeping, then the open questions.

From symptom to cause

Checklist

• Does every informative image have a descriptive alt sentence?
• Do decorative images carry an empty alt attribute?
• Is the alt text free of keyword piles?
• Are file names descriptive, and chosen before upload?
• Do you know which of title, caption and description your theme prints?
• Are important images inserted as img elements with a src?
• Do linked images describe where the link goes?
• Have you looked at one attachment page and recorded a decision?
• Were unattached files checked against live pages before deletion?

Decision rule: which field first

Practical suggestion: when time is short, work in this order.

1. Alt text on informative images, starting with the pages readers actually use.
2. Findability: image element, src attribute, position near the related text.
3. File names and titles that make the library searchable.
4. Captions where they teach the reader something new.
5. Descriptions and attachment page settings, since the documentation says little about them.

You do not have to fill every field on every image. A field with no purpose costs maintenance time and gives the reader nothing. Fill what you have proven useful on your own site.

Frequently Asked Questions

Do I have to fill alt text, title and description for every image?

No. The WordPress page defines alt text for accessibility and says the title appears on attachment pages and in galleries only if a theme or plugin is built to display it. Google's page names alt text as the most important image metadata.

Does keyword-rich alt text help rankings?

No. Google's page says filling the alt attribute with keywords creates a negative user experience and may cause the site to be seen as spam.

Should I redirect or noindex attachment pages?

The documents do not say. The Media Library page only describes the "View attachment page" link. Decide from the content of your own attachment pages and test the result.

Does the file name matter?

Google asks for short, descriptive file names and asks you to avoid generic names such as image1.jpg or 1.jpg where possible.

Will Google index an image I add as a CSS background?

According to Google's page, images added through CSS are not indexed. Add the pictures you want found as img elements with a src attribute.

Is it safe to delete unattached images?

Verify first. The "Unattached" filter lists media not attached to a post or page, but a file can still be used in a widget or theme setting, and "Delete Permanently" cannot be undone.

Conclusion

The four media fields do different jobs. Alt text describes the image and is, in Google's words, the most important metadata for it. Title, caption and description appear where your theme and plugins print them, and the documentation leaves the description field's location open. Name files before upload, insert key pictures as img elements, check unattached files against live pages before deleting, and treat attachment pages as an open question the documents do not settle.

If you want readers to find copy that earns the pictures beside it, look at our content writing service.