Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

All images, either standalone or embedded in a document or slide deck, need to have alternative text (commonly called “alt text”) that describes the content and function of the image.

General Guidelines for Writing Good Alt Text

If an image is purely decorative and does not convey any information, you can simply put “decorative” as the alt text.

Generate Alt Text with AI Tools

Writing alt text takes time. Luckily, AI tools can help generate initial drafts of alt text. You still need to review and edit for accuracy and clarity, but AI tools can save significant time.

Upload the image to an AI chatbot (e.g., ChatGPT, Microsoft Copilot). Note that the image should not contain sensitive or private information. Then, give the AI chatbot a prompt like the following:

Generate alternative text for the uploaded image. Keep it concise.

(Optional but recommended) This image is used in the context of [briefly describe the context or topic, e.g., illustrating coordinate transformation].

After the AI chatbot generates the alt text, review and edit it as needed. Do not skip this step!

How to Add Alt Text

Depending on the software you are using, the steps to add alt text to an image may vary:

For software not listed above, generally, you can right-click on the image and look for an option like “Add Alt Text” or “Add Image Description”. Sometimes, this option may be hidden under “Format” or “Properties” on the menu.