Support Log in

Image SEO

User Guide
Prefer video? Watch the Rank Forge tutorials 9 short guides covering every feature Watch

Images play a much larger role in SEO than most content managers realize. Images with proper alt text can bring visitors to your site through image search results. Alt text also makes your site accessible to visitors who use screen readers — a legal requirement in many countries. When you upload an image, Image SEO in Rank Forge fills in the alt text from the file name if the image has none yet, so you do not start from an empty field. It is part of the Free core.

Why Alt Text Matters

ReasonHow It Affects You
Google uses alt text to understand imagesGoogle cannot “see” images — it reads the alt text to determine what the image shows and whether it is relevant to a search query
Google Images searchUsers searching Google Images find your content through descriptive alt text, driving additional traffic
Screen readersVisually impaired visitors use screen readers that read alt text aloud — proper alt text makes your site accessible to everyone
SEO score impactMissing alt text is flagged as an issue in Rank Forge, lowering your page’s score
Legal complianceMany countries require websites to meet accessibility standards that include image alt text

How Auto Alt Text Works

When you upload an image to the WordPress media library, Rank Forge generates alt text from the file name in these steps:

  1. Reads the filename — filenames often contain useful descriptions (e.g., blue-mountain-cabin-exterior.jpg)
  2. Cleans it up — at the end of the name it removes first a size such as 800×600, then a word such as scaled, edited, copy, final or v3
  3. Converts to readable text — turns dashes, underscores and dots into spaces and capitalizes each word
  4. Adds context — if the image is uploaded to a post, the title of that post is added after the file name

Examples of Auto-Generated Alt Text

Original FilenameGenerated Alt TextQuality
blue-mountain-cabin-exterior-800x600.jpgBlue Mountain Cabin ExteriorGood — descriptive filename produces useful alt text
homemade-sourdough-bread-recipe.jpgHomemade Sourdough Bread RecipeExcellent — filename matches the content perfectly
team-meeting-2026-q1-review.jpgTeam Meeting 2026 Q1 ReviewGood: useful description retained
IMG_2847_final_v3.pngImg 2847 FinalPoor: a generic filename produces a generic alt text that should be edited manually
photo-1.jpgPhoto 1Poor: needs manual editing to be useful

Step-by-Step: Managing Alt Text

  1. During upload: Alt text is generated automatically when you upload a new image via the media library or directly within a post.
  2. Reviewing alt text: Go to Media > Library, click on any image, and check the Alt Text field.
  3. Editing alt text: Click in the Alt Text field, edit the auto-generated text to be more descriptive, and click Save.
  4. Editing in the post editor: Click on any image in your post content, open its settings (block sidebar in Gutenberg), and edit the alt text directly.
  5. Bulk review: Use the Media Library in list view to scan all images and identify any with generic or missing alt text.

Best Practices for Image Alt Text

DoDo Not
Be descriptive and specific: “Golden retriever puppy playing fetch in a park”Be vague: “dog”
Keep it under 125 charactersWrite a paragraph — screen readers may cut off long alt text
Include your focus keyword naturally if the image is relevantForce the keyword into every image alt tag
Describe what is in the image objectivelyStart with “Image of” or “Picture of” — screen readers already announce it as an image
Give unique alt text to each imageUse the same alt text on every image in a post

Real-World Example

You upload five photos in the Media Library for a blog post about “best standing desks for home office”. Rank Forge writes the alt text from the file name (an image uploaded from inside a post also gets a dash and the title of that post after the text):

  1. standing-desk-comparison-chart.jpg — Auto: “Standing Desk Comparison Chart” — Keep as-is (perfect).
  2. ergonomic-desk-setup-home.jpg — Auto: “Ergonomic Desk Setup Home” — Edit to: “Ergonomic standing desk setup in a home office with monitor arm and keyboard tray.”
  3. IMG_3392.jpg — Auto: “Img 3392” — Edit to: “Wooden standing desk with adjustable height mechanism, shown at standing position.”
  4. FlexiSpot-E7-front-view.jpg — Auto: “Flexispot E7 Front View” — Edit to: “FlexiSpot E7 standing desk front view showing the dual-motor frame and bamboo desktop.”
  5. desk-cable-management.jpg — Auto: “Desk Cable Management” — Edit to: “Under-desk cable management tray keeping cords organized and hidden.”

> Tip: Even with auto-generated alt text, review the alt text on your most important pages. Images with descriptive filenames get great auto alt text, but images with generic filenames (like IMG_2847.jpg) need manual improvement.

> Good to know: Rank Forge builds the auto alt text from the file name, so renaming your image files before uploading changes the alt text. Instead of uploading IMG_2847.jpg, rename it to sourdough-bread-cooling-rack.jpg first.

Common Mistakes

  • Leaving the alt text of generic file names as it is, such as “Img 3392”. If your file names are generic, the auto alt text will be too. Always review.
  • Keyword-stuffing alt text. Writing “best standing desk best standing desk review best standing desk 2026” as alt text is spam. One natural keyword mention per image is enough.
  • Leaving decorative images without empty alt text. Purely decorative images (borders, spacers, backgrounds) should have empty alt text (alt=""), not descriptive text.

—

Forge AI Assistant Online

Hi! I'm the Rank Forge AI assistant. Ask me anything about the plugin — setup, features, troubleshooting, or development.

Just now
Powered by Forge AI · Browse docs