# Require Edit Reason

**URL:** <https://meta.discourse.org/t/require-edit-reason/124593>\
**Category:** Theme component\
**Created:** [August 1, 2019, 9:50am UTC](https://meta.discourse.org/t/require-edit-reason/124593 "2019-08-01T09:50:25Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/580155_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)\
**Post date:** [August 1, 2019, 9:50am UTC](https://meta.discourse.org/t/require-edit-reason/124593/1 "2019-08-01T09:50:26Z")

</div>

The purpose of this component is to encourage users to add edit reasons when they edit a post. Edit reasons are displayed at the top of a post’s edit history modal and are a great way to understand why something within a post was changed. This might be especially useful for users that are able to edit other users’ posts as it will help to avoid any “why did you edit my post?!” responses.

### How it Works

When someone opens the composer to edit, the edit reason field is exposed and marked required. The save button is disabled until the reason is added.

 ![The image shows a text editor with partially written text and added text in red, indicating that the user is currently editing. (Captioned by AI)](https://global.discourse-cdn.com/meta/original/4X/7/2/0/720209643b5436c9833f0bfc96f689123d6e15af.png)

Once a reason is added, the edit can be saved

 ![The image shows a keyboard and mouse screenshot with a text caption edited with a "spelling fix" chapter title, featuring a page number, text highlighted for emphasis, and missing words. (Captioned by AI)](https://global.discourse-cdn.com/meta/original/4X/6/d/a/6da45a5b83aa6a96807b0028b5c2112a15eadef4.png)

### Configurable Settings

 ![The image shows a configuration setting for requiring contributors to provide an edit reason, with a trust level of 0, and a 0-minute grace period for editing without a reason. (Captioned by AI)](https://global.discourse-cdn.com/meta/original/4X/0/a/1/0a14bd33615c74b438910b5184aa07e05acdd094.png)

> ⭐ **Pro-tip:** If you want to require **all** users to add edit reasons, simply add the `trust_level_0` group to the “edit reason required groups” theme setting.

### Installation

[Repository Link](https://github.com/tshenry/discourse-require-edit-reason)  
`https://github.com/discourse/discourse-require-edit-reason`

If you are unfamiliar with theme components and how to install them, check out the [theme installation guide](https://meta.discourse.org/t/how-do-i-install-a-theme-or-theme-component/63682). And if you’d like to learn more about Discourse themes, take a look at [this guide](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966).

---

_[View the full topic](https://meta.discourse.org/t/require-edit-reason/124593)._