--- title: "Create Alt Text for Images" slug: "create-alt-text-for-images" description: "Ensure web accessibility by adding accurate and succinct alt text to all images, improving usability for all users, including those using screen readers." updated: 2026-05-04T16:25:10Z published: 2026-05-04T16:25:10Z canonical: "www.civicplus.help/create-alt-text-for-images" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Create Alt Text for Images All images need to have succinct, accurate, and equivalent Alt Text. This will be read by screen readers and should present the content and function of an image. Read more about [alt text tips and tricks from the W3C (World Wide Web Consortium) WAI (Web Accessibility Initiative)](https://www.w3.org/WAI/tutorials/images/tips/). > [!NOTE] > Important Note: > > CivicPlus works toward WCAG 2.0 AA accessibility standards and our websites are highly compliant when they go live. However, ongoing ADA compliance and maintenance is the **customer's responsibility**. > [!TIP] > Who can use this feature? > > System Administrator | Owner | Publisher | Author ## Alt Text Tips & Guidelines - Alt text should not contain redundant phrases like “image of” or “graphic of” - Alt text for two images cannot be the same. - If there are two photos of a river, for instance, on a page, either distinguish them by saying “River 1” and “River 2” or write more specific alt text such as “East side of the river” and “Close-up of river water” - If an image contains words, add as much of the text from the image as possible to the alt text (100-character limit). - Alt text should not contain file extensions, such as .jpg. It should be easily readable and describe what is happening in the image - See the following explanation for using file extensions in the alt text ### Complex Images - Some examples of complex images can include charts, graphs, maps, or images of text. - When text is displayed in an image, that text should be used as the image's alt text. - A link should be provided to an accessible format of the image's information. - To learn more about how alt text can be applied to images of text, review the [WCAG (Web Content Accessibility Guidelines) Success Criterion 1.4.5](https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-text-presentation.html). ### Linked Images - If the image functions as a link, the alt text should describe where the image will take the user - For instance, if an image showed a Swoosh and linked to the Nike Website, the appropriate alt text would be “Nike.” A screen reader would identify the link and add “site” or “link,” therefore writing “Nike Website” as alt text would be redundant, and “Nike Logo” would not make sense - If the image links to a document, the alt text should contain the file extension. - For example, if you have a cover image of the annual report, the alt text would be “Annual Report (PDF)” - If the image links to a larger version of itself, the alt text should read with the file extension - For example, an image of a map linking to a larger version of itself should have the alt text “Map of Downtown (JPG)” --- ## Update Alt Text While Inserting an Image [Embedded content](https://www.iorad.com/player/1932696/Web-Central--How-to-Create-Alt-Text-for-an-Image-Tutorial) 1. [Sign in to your website](/municipal-websites-central/docs/sign-in-to-your-site) > [!WARNING] > **Note**: > > This process may look different based on how your site was designed. 2. Navigate to the page you wish to add an image to 3. Make sure the **Live Edit state** is toggled **ON**: ![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Live Edit On - MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=z7X7Hc0BidFK%2Bs6r1xWGpVcLsZtPWOeEpK1HB4L4Wbk%3D) 4. Select the **Widgets tab** from the Live Edit panel:![The Live Edit tabs with the Widgets tab highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Live Edit Tabs Widgets Tab - MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=hAFxs8AW2pQkWMdELVyNIh1lmnjJ4fTjaFknEAEAnXo%3D) 5. Click the **Image Widget** to drag-and-drop it in the location on the page: ![The Image widget being drag-and-dropped to a page.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Drag-and-Drop%20Image%20Widget%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=vgQPYfBdN9sGMEXA5iu2yP66D%2BZ7BfbXkrpofUTFJeI%3D) 6. **Locate the image** to add to the page: > [!WARNING] > **Note**: > > To easily locate your image, you can Search for its Display Name or ID:![The Search for Display Name or ID field on the Content Images window.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Search%20Display%20Name%20or%20ID%20Field%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=7m%2F9EOnd6CqDKkYMAT7hePpqwaWbj0YbfwrY%2Fe3Cer4%3D) 7. Click the **Actions button** next to the image: ![The Content Images pop-up box with the Actions button for an image highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Images%20Actions%20Button%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=E%2BWl9oeRZjQm4HhX6We7Nl2Gg8L1MDUHEj70Banycjo%3D) 8. Select the **Modify** option: ![The Content Images pop-up box with the Action menu for an image expanded, and the Modify option highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Images%20Actions%20Modify%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=22MIncReRvn4ntgvfe9uTMDxJ64RutSX46ns%2B%2FJ2eiU%3D) 9. Add **Alt Text** to clearly explain what is happening in the image: ![The Content Images pop-up window with the Alt Text field for an image highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Images%20Alt%20Text%20Field%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=7J2r4AKe15B6j0J6zBALVgiwrXl5ZNLhnq9fzL9ckfo%3D) - [Accessibility Compliance:](https://www.w3.org/WAI/tutorials/images/tips/) Make the alt text as compliant as you can and keep it consistent with the image’s purpose 10. Click the **Save button** in the Content Images pop-up window: ![The Content Images pop-up window with the Save button highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Images%20Save%20Button%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=fPLPfxtlferfUvQ66JxVaNI8mZzQHelRo2jlH%2Bx6BnE%3D) 11. Click the **Insert button**: ![The Content Images pop-up window with the Insert button for an image highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Images%20Insert%20Button%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=UlgoN8qFTlRKs9%2BrvaN45LAf4N6gQXclGaW%2BVTaztPQ%3D) 12. (Optional) [Edit the image](/municipal-websites-central/docs/image-editor-tools) as desired or [create a linked image](/municipal-websites-central/docs/linking-images) 13. Click the **Save button**: ![The Save button in the top right corner of the page.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Save Page - MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=Cj9gM9mwpbcgehGZtYPUyedNnqdfd4nfjsscbGBJDmQ%3D) --- ## Add/Update Alt Text for an Existing Inserted Image 1. [Sign in to your website](/municipal-websites-central/docs/sign-in-to-your-site) > [!WARNING] > Note: > > This process may look different based on how your site was designed. 2. Navigate to the page you wish to add an image to 3. Make sure the **Live Edit state** is toggled **ON**: ![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Live Edit On - MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=z7X7Hc0BidFK%2Bs6r1xWGpVcLsZtPWOeEpK1HB4L4Wbk%3D) 4. Click inside the Editor widget in which the image has been inserted 5. Click the image to bring up the Image Toolbar: ![The Editor widget, opened for editing with the Image Toolbar displayed and highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Editor%20Widget%20Access%20Image%20Toolbar%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=71LkEiqnALjLBlab%2Fa8z4wlw8%2BUOcGljCWN7zPehh0U%3D) 6. Click the Alt Text icon: ![The Editor widget opened for editing, with the Image Toolbar displayed and the Alt Text icon highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Editor%20Widget%20Image%20Toolbar%20Alt%20Text%20Icon%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=sCQQXSndLndajaagzU3u9nQhU3%2FhiCghVYDl3GQL97U%3D) 7. Use the Alternative Text field to add or update the Alt Text for the image: ![The Editor widget with the Alternative Text field for an image displayed and highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Image%20Alternative%20Text%20Field%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=VGFUvNxArDfQ5b%2Bl2jGhWy7OpSF6MLlhckYJgS72vTU%3D) 8. Click **Update** to finish your work: ![The Image Alternative Text field and the Update button highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Image%20Alternative%20Text%20Update%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=KuGrRGjFKpUXWGwkuEy96gx31BlBLPZuiXzVDBsPQlQ%3D) 9. Click the **Done Editing (checkbox) icon** to close the Editor Widget ![The Done Editing (checkmark) button to close an Editor Widget.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Done Editing Button - MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=GBmHOcfnX0ANrn%2Fj%2FyICPNVr%2B6nJCLbdC61vBDcz9II%3D) 10. Click **Save** to save your work: ![The Save button in the top right corner of the page.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Save Page - MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A25%3A11Z&se=2026-11-22T14%3A25%3A11Z&sr=b&sp=r&sig=Cj9gM9mwpbcgehGZtYPUyedNnqdfd4nfjsscbGBJDmQ%3D) --- ## Additional Resources - [Understanding WCAG (Web Content Accessibility Guidelines) | Overview](https://www.w3.org/TR/UNDERSTANDING-WCAG20/Overview.html) - [Understanding WCAG (Web Content Accessibility Guidelines) | Success Criterion 1.1.1 | Non-text Content](https://www.w3.org/TR/UNDERSTANDING-WCAG20/text-equiv-all.html) - [Understanding WCAG (Web Content Accessibility Guidelines) | Success Criterion 1.4.5 | Images of Text](https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-text-presentation.html) - [W3C (World Wide Web Consortium) WAI (Web Accessibility Initiative) Images Tutorial](https://www.w3.org/WAI/tutorials/images/) Alternate Text. A text attribute applied within the properties of an image that describes the image for the use of screen readers and will display if the image does not load correctly. Web Content Accessibility Guidelines. A part of a series of web accessibility guidelines published by the Web Accessibility Initiative (WAI) of the World Wide Web Consortium (W3C), the main international standards organization for the Internet. Americans with Disabilities Act. The Americans with Disabilities Act is a civil rights law that prohibits discrimination based on disability. It guarantees equal opportunity for individuals with disabilities in public accommodations, employment, transportation, state and local government services, and telecommunications. Portable Document Format. Joint Photographic Experts Group. Identification or Identifier.