--- title: "How to Write Alt Text for Website Images | MCC Solutions" description: "Alt text helps people using screen readers and gives search engines context. Learn what to write for photos, logos, icons and buttons, with examples." url: "https://mcc-solutionsnj.com/websites/guides/how-to-write-alt-text-for-website-images" --- Guide · Updated October 12, 2026 # How to Write Alt Text for Website Images Alt text is a short written description attached to an image. A screen reader reads it aloud for visitors who cannot see the picture. Browsers display it if the image fails to load. Search engines use it as one clue about the image. Writing it well takes a minute per image. By [Matthew Coleman](/about), MCC Solutions **Quick answer.** Alt text is a short written description of an image that screen readers read aloud and browsers show if the image fails to load. Imagine reading the page aloud over the phone: describe the picture's purpose in context, not every visual detail. **Free tools:** [Free website SEO check](/websites/seo-checker) · [Search result preview](/websites/search-result-preview) ## What good alt text does Imagine reading the page aloud to a friend over the phone. Where an image carries meaning, you would describe it briefly. That description is the alt text. It should convey the purpose of the picture in the context of the page, not every visual detail. A photo of a technician fitting a water heater on a service page might have alt text such as Technician installing a tank water heater in a basement utility room. ## How long and how detailed Aim for a short phrase or one sentence, commonly under about 125 characters. Skip the words image of or photo of, since assistive software already announces it is an image. Be specific rather than generic: water heater installation beats service. Mention a keyword only if it naturally describes the image. Stuffing a list of terms helps no one and can look manipulative. ## Different image types For a logo linked to the home page, the alt text should say the business name, and perhaps home. For a button that is an image, describe the action, such as Call us, not the icon shape. For charts or infographics, give a short summary and put the full data in nearby text. Decorative images that add nothing, like divider lines or background flourishes, should have empty alt text so screen readers skip them. Leave the attribute present but blank, rather than omitting it. ## Common mistakes Leaving the filename as alt text, such as IMG_2231.jpg, or repeating the same phrase on every image. Writing paragraphs. Placing important text only inside images. Describing stock photos as if they were your own work, which can mislead. Using the title field instead of alt. Also avoid alt text that contradicts the visible caption. If a caption already describes the photo fully, a brief alt is enough. ## How to add and audit it In WordPress, open the media library and fill the Alternative Text field. Builders usually show a similar box in the image settings. For a hand-coded site, add the alt attribute in the image tag. To audit, use a browser extension or crawler that lists images missing alt text, then work through the most important pages first. Make adding alt text part of your upload routine so you never build a backlog. ## A before-and-after example Weak: photo.jpg, or plumber cheap plumber near me emergency plumber. Better: Plumber checking a copper pipe under a kitchen sink. The first tells a screen reader user nothing and looks like stuffing. The second tells them what is happening and still gives context for search engines. If you manage a large media library, prioritize in this order: images on service pages, then the home page, then blog posts, then old archives. A steady habit beats a one-time cleanup. Treat the text as part of the content, not an afterthought. When writing a service page, decide what the photos are meant to show, and let that guide both the picture you pick and the sentence that describes it. ## Common questions **Does alt text help SEO?** It gives search engines context, especially for image search, but it is mainly an accessibility feature. **Do I need alt text on every image?** Every image needs the attribute. Meaningful images need a description; decorative ones should be empty. **Should I put my city in alt text?** Only if the location is part of what the image shows. Avoid repeating it on every image. This guide is general information. Search engines change how they work and their guidelines; check Google's current documentation for your situation. Nobody can guarantee a ranking. Let us handle it [### Website design Fast, mobile-first small business websites built by a New Jersey firm, with a fixed written quote. You own the domain, hosting and content. Website design →](/websites/services/website-design)[### Technical SEO & schema markup Technical SEO for small business websites: indexing, sitemaps, redirects, canonical tags and schema markup for local businesses and services. Technical SEO →](/websites/services/technical-seo-and-schema) More guides - [Color Contrast and Readable Text on Your Website](/websites/guides/color-contrast-and-readable-text-on-your-website) - [Keyboard Navigation and Form Labels: Accessibility Tests](/websites/guides/keyboard-navigation-and-form-labels-accessibility) - [Cookie Banner Basics for Small Business Websites](/websites/guides/cookie-banner-basics-for-small-business-websites) - [What to Include in a Small Business Privacy Policy](/websites/guides/privacy-policy-page-for-a-small-business-website) Free tools - [Website basics check](/websites/seo-checker) - [Is your website working for you? quiz](/websites/quiz) [All guides](/websites/guides) Reach small business owners working on their website and Google listing who read this guide: [advertise here](/advertise#websites). Do it yourself ### Small Business Website Starter A fast, mobile-friendly one-page site you edit in a text editor and host anywhere, with the sections a local service business needs and a plain setup guide. [See what's inside ($29)](/toolkits/small-business-website-starter) [Free sample](/toolkits/small-business-website-starter#free-starter)14-day full refund ## Rather have us handle it? Ask for a quote. [Get a Quote](/websites/#quote)[Call (908) 444-6373](tel:+19084446373)