πΌοΈ What this article covers
If you add or edit image alt text in OTTO, select deploy, and the live page still shows the old text or no alt text, use the checks below. Alt text is the short description stored on an image so search engines and screen readers can understand it.
βοΈ Why the alt text may not change
- The edit was saved, but the image was not deployed. Open Image alt text, find the image, and select Deploy. Deployed means the change is being sent to the live site.
- Check the imageβs status in Image alt text. It should say Deployed. If it still says Deploy, select it. For a bulk deploy, wait for the completion message, which can also say that some images were skipped.
- The wrong image or page was updated. Pages can contain several similar images.
- The image may be decorative. OTTO hides decorative images, such as icons, arrows, and spacers, and does not add alt text to them. It also changes only standard img tags, so an image painted as a CSS background is not updated.
- A cached copy is showing. Your browser, site cache, or CDN may still serve the previous page.
- The page was changed again in your site after OTTO deployed, which can overwrite the update.
π οΈ Update and deploy the alt text again
- Open OTTO, select Image alt text, and find the image. The list shows every page where that image appears.
- Enter clear, specific alt text that describes the image. Keep it short and avoid stuffing keywords.
- Select Save, then select Deploy for that image. When its status says Deployed, check the live page. You may need to refresh it.
- If several images look alike, confirm you edited the correct one by matching the image preview or file name.
- If the image still says Deploy, select Deploy again. Check its status before deploying it again.
π Confirm the live page
- Open the live page in a private or incognito window so you are not viewing an old cached copy.
- Hard refresh the page. On most browsers, hold Ctrl and press F5, or hold Cmd and Shift and press R on Mac.
- Right-click the image, choose Inspect, and look for the alt value on the image tag. That is the text currently published.
- If your site uses a cache or CDN, clear that cache for the page, then check again.
- Search results can lag behind the live page. Judge success by the page source, not by how soon Google shows the new text.
π If it still does not update
- Check that the image is a real image element on the page, not a background image.
- A later edit in your website builder or CMS can change the alt text stored on the page, but a deployed OTTO change still replaces it on the live page. If the image no longer matches, deploy the image again.
- If a bulk deploy reports skipped images, review those images and deploy them again. A single image has no error status. If it does not say Deployed, select Deploy again.
- Note the page URL, image file name, the alt text you entered, and the time you deployed. These details speed up a review.
π‘ Good alt text habits
Describe what is actually in the image, such as the product, person, or scene. Skip phrases like image of. Use empty alt text only for purely decorative images when your workflow supports that. After any successful fix, recheck one live image so you know future deploys are sticking.
If you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.