# Editing image alternative (alt) text

**URL:** https://meta.discourse.org/t/editing-image-alternative-alt-text/208746
**Category:** Announcements
**Tags:** new-feature
**Created:** [June 6, 2022, 3:04pm UTC](https://meta.discourse.org/t/editing-image-alternative-alt-text/208746 "2022-06-06T15:04:21Z")
**Posts on this page:** 6
**Page:** 1

<div class="post-metadata">

### Author: ![nat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nat/32/235063_2.png) [@nat](https://meta.discourse.org/u/nat)
#### Post date: [June 6, 2022, 3:04pm UTC](https://meta.discourse.org/t/editing-image-alternative-alt-text/208746/1 "2022-06-06T15:04:21Z")

</div>

To better support our friends on screen readers, and help with indexing on search engines, we’ve introduced the ability to edit your image’s alt text in the preview. We hope this feature can make it easier to [update our image descriptions](https://accessibility.huit.harvard.edu/describe-content-images)!

![Video demonstrating annotation process in composer](https://global.discourse-cdn.com/meta/original/3X/d/6/d6a64012c24d50cc2f600a5e50faad41287739a2.gif)

To enter a description you can press the pencil icon at the bottom of an image and enter a description. This saves time cause you no longer need to edit the markdown directly.

Related topic:

> [@Encourage/enforce adding image descriptions](https://meta.discourse.org/t/what-s-the-best-way-to-add-image-descriptions/166017):
>
> We have a practice of always adding image descriptions in order to make Discourse accessible to people who use screen readers. What are some best ways to support adding image descriptions? For example, is it possible for help text to show up that tells people to add an image description? “You’ve added an image! Please add an image description before you create the topic.” And, how do we add alt-text? More on image descriptions [https://uxdesign.cc/how-to-write-an-image-description-2f30d3bf…](https://uxdesign.cc/how-to-write-an-image-description-2f30d3bf5546)

---

<div class="post-metadata">

### Author: ![Decorbuz](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/decorbuz/32/235124_2.png) [@Decorbuz](https://meta.discourse.org/u/Decorbuz)
#### Post date: [June 7, 2022, 12:45am UTC](https://meta.discourse.org/t/editing-image-alternative-alt-text/208746/5 "2022-06-07T00:45:50Z")

</div>

I have two questions.

1. Is this any different from manually removing the alt text _manually_?
2. Is it possibly to completely remove the alt text through edit box in the preview? Will it just spit out an error?

Otherwise, this will be very convenient for me. 😀

---

<div class="post-metadata">

### Author: ![nat](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/nat/32/235063_2.png) [@nat](https://meta.discourse.org/u/nat)
#### Post date: [June 7, 2022, 3:26am UTC](https://meta.discourse.org/t/editing-image-alternative-alt-text/208746/6 "2022-06-07T03:26:23Z")

</div>

> [@Decorbuz](#):
>
> Is this any different from manually removing the alt text _manually_?

I assume you mean removing the alt text from the composer: no, there is no difference. Some users get intimidated by modifying the markdown directly, especially when filenames may become cryptic, so this is a good alternative.

> [@Decorbuz](#):
>
> Is it possibly to completely remove the alt text through edit box in the preview? Will it just spit out an error?

We’ve not added any validation to ensure alt texts are always present. So no errors yet 🙂

---

<div class="post-metadata">

### Author: ![Decorbuz](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/decorbuz/32/235124_2.png) [@Decorbuz](https://meta.discourse.org/u/Decorbuz)
#### Post date: [June 7, 2022, 3:44pm UTC](https://meta.discourse.org/t/editing-image-alternative-alt-text/208746/7 "2022-06-07T15:44:19Z")

</div>

> [@nat](#):
>
> I assume you mean removing the alt text from the composer: no, there is no difference. Some users get intimidated by modifying the markdown directly, especially when filenames may become cryptic, so this is a good alternative.

Okay, thank you for clarifying.

---

<div class="post-metadata">

### Author: ![debryc](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/debryc/32/101652_2.png) [@debryc](https://meta.discourse.org/u/debryc)
#### Post date: [June 11, 2022, 12:40am UTC](https://meta.discourse.org/t/editing-image-alternative-alt-text/208746/8 "2022-06-11T00:40:51Z")

</div>

I just tried it! Worked great! Thank you.

I continue to advocate for a pop-up option (like the add link interface) that appears whenever someone adds an image (can be a setting that’s turned on or off). Hoping that’s in the plans 🤞

---

<div class="post-metadata">

### Author: ![tobiaseigen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tobiaseigen/32/539204_2.png) [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [May 12, 2025, 3:19pm UTC](https://meta.discourse.org/t/editing-image-alternative-alt-text/208746/9 "2025-05-12T15:19:19Z")

</div>


