# Provide more guidance for flag actions on Review page

**URL:** https://meta.discourse.org/t/provide-more-guidance-for-flag-actions-on-review-page/139052
**Category:** Feature
**Tags:** review-queue
**Created:** [18 januari 2020 om 21:02 UTC](https://meta.discourse.org/t/provide-more-guidance-for-flag-actions-on-review-page/139052 "2020-01-18T21:02:49Z")
**Posts on this page:** 6
**Page:** 1

<div class="post-metadata">

### Author: ![BOUCUR](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/boucur/32/169053_2.png) [@BOUCUR](https://meta.discourse.org/u/BOUCUR)
#### Post date: [18 januari 2020 om 21:02 UTC](https://meta.discourse.org/t/provide-more-guidance-for-flag-actions-on-review-page/139052/1 "2020-01-18T21:02:49Z")

</div>

![image](https://global.discourse-cdn.com/meta/original/3X/a/3/a31a7a2b8022e10a4790b7da84464de61dc33edb.png)

Actions on flags (`Agree`, `Disagree`, `Ignore`, `Delete`) have confused me and other moderators on our forum. It’s not always clear what is going to happen when you select one of the options, which we find prevents some moderators, including myself, from feeling confident enough to take action on certain flags. Flagged inappropriate content is, thankfully, rare enough that we don’t have these buttons and all their actions memorized. For some context, our forum is around a year old and most of us have been moderating for that entire period.

More guidance to moderation on the Review page would be greatly appreciated, such as

- hovertext or (?) icons near flag action buttons to help describe what will happen when clicked,
- some indication that clicking the button will open a subset of options (vs. cause a moderation action to occur immediately),
- descriptions on the sidebar,
- or even just a link to the [Moderation Guide](https://meta.discourse.org/t/discourse-moderation-guide/63116#heading--flags) (editable, if a forum has their own).

Some points of confusion that have come up are listed below (these aren’t questions that I am asking to be answered, just questions that have come up based on the confusing-to-us design):

- Will clicking the button immediately cause an action to occur, or will I be presented with a subset of options? For example:
  - Moderator is unaware: will clicking `Agree` with flag immediately hide the post? (No, after clicking Agree, you are presented with 4 options: `Hide`, `Keep`, `Suspend User`, or `Silence User`")

- Being unaware that an automated message will be or was sent on the moderator’s behalf to the _flagger_ to. Moderation action may have already occurred before resolving the flag.
- Does pressing `Ignore` ignore it for just me, or does it ignore the flag for other moderators too?
- A `Delete` button next to a flag is mostly likely to be read as `Delete flag`, not `Delete post`. Primary delete button should indicate what is about to be deleted.

thanks for your thoughts(, and feel free to just edit this post if I misrepresented how any moderation tools currently work)

---

<div class="post-metadata">

### Author: ![ondrej](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ondrej/32/198804_2.png) [@ondrej](https://meta.discourse.org/u/ondrej)
#### Post date: [18 januari 2020 om 21:59 UTC](https://meta.discourse.org/t/provide-more-guidance-for-flag-actions-on-review-page/139052/2 "2020-01-18T21:59:51Z")

</div>

> [@BOUCUR](#):
>
> not always clear what is going to happen when you select one of the options

I can refer to that but only when I started to moderate. Also, I think it is clear what each option will do (after a few flags that was 🙂).

> [@BOUCUR](#):
>
> Does pressing `Ignore` ignore it for just me, or does it ignore the flag for other moderators too?

It means that the flag requires no action at this time.

> [@BOUCUR](#):
>
> A `Delete` button next to a flag is mostly likely to be read as `Delete flag` , not `Delete post` . Primary delete button should indicate what is about to be deleted.

But a user flags a post. So I am not sure how a _delete_ button is confusing next to the options _agree, disagree_ and _ignore_. It has to be delete post.

* * *

---

<div class="post-metadata">

### Author: ![papyrophilia](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/papyrophilia/32/161518_2.png) [@papyrophilia](https://meta.discourse.org/u/papyrophilia)
#### Post date: [20 januari 2020 om 19:32 UTC](https://meta.discourse.org/t/provide-more-guidance-for-flag-actions-on-review-page/139052/3 "2020-01-20T19:32:04Z")

</div>

> [@ondrej](#):
>
> > [@BOUCUR](#):
> >
> > **A `Delete` button next to a flag is mostly likely to be read as `Delete flag` , not `Delete post` .** Primary delete button should indicate what is about to be deleted.
> 
> **But a user _flags_ a post.** So I am not sure how a _delete_ button is confusing next to the options _agree, disagree_ and _ignore_ . **It has to be delete post.**

Hi @ondrej and @BOUCUR–

It’s a bit like the fortune cookie game, where you add the same phrase (e.g., “in jail”) after reading every fortune. My reading of the flag actions is…

- **agree** _with flag_
- **disagree** _with flag_
- **ignore** _flag_
- **delete** _flag???_ – I don’t _intuitively_ jump to “post” here.

My belief is that additional clarity–and fewer assumptions needed on the part of the user–can only be helpful. 😁

---

<div class="post-metadata">

### Author: ![ondrej](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ondrej/32/198804_2.png) [@ondrej](https://meta.discourse.org/u/ondrej)
#### Post date: [20 januari 2020 om 20:13 UTC](https://meta.discourse.org/t/provide-more-guidance-for-flag-actions-on-review-page/139052/4 "2020-01-20T20:13:56Z")

</div>

> [@papyrophilia](#):
>
> delete

Is it just me who thinks it is delete post? 😂

* * *

`reviewables.actions.delete.title`

Change this I think it is the right one

**Delete Post**

which makes it way more clear:

 ![image](https://global.discourse-cdn.com/meta/original/3X/a/5/a57b4abe53e2090e5a6019ddd9e8ff034d8b2438.png)

---

<div class="post-metadata">

### Author: ![jomaxro](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jomaxro/32/126216_2.png) [@jomaxro](https://meta.discourse.org/u/jomaxro)
#### Post date: [20 januari 2020 om 21:23 UTC](https://meta.discourse.org/t/provide-more-guidance-for-flag-actions-on-review-page/139052/5 "2020-01-20T21:23:13Z")

</div>

> [@BOUCUR](#):
>
> some indication that clicking the button will open a subset of options (vs. cause a moderation action to occur immediately),

The `...` is the indication. Any button with `...` will not take immediate action, but open a dropdown (or modal) where you then take action.

> [@BOUCUR](#):
>
> or even just a link to the [Moderation Guide](https://meta.discourse.org/t/discourse-moderation-guide/63116#heading--flags) (editable, if a forum has their own).

Interesting idea. On my long-term todo list is another topic which goes more in-depth into the review queue, if we add a link it should likely be to that once created.

> [@BOUCUR](#):
>
> hovertext

We could definitely make better use of `title` attributes here, no question. At the moment, `title` for `Agree...` and `Delete...` simply repeat the text on the button, and there’s no `title` attribute or disagree or ignore.

> [@BOUCUR](#):
>
> A `Delete` button next to a flag is mostly likely to be read as `Delete flag` , not `Delete post` . Primary delete button should indicate what is about to be deleted.

I can see the confusion here. We in essence have “Agree with flag and …”, “Disagree with flag”, “Ignore flag”, and “Delete post and …”. That’s clearly not consistent.

As @ondrej mentioned, you can edit the button text for your site, but we’ll look into improving this globally.

* * *

Also, just to check, queue posts and queued users don’t cause any confusion for your staff, right? Those reviewables are a bit clearer:

 ![image](https://global.discourse-cdn.com/meta/original/3X/9/2/923ec5df4665c945f6f1123cba4525c22c2f132f.png)

---

<div class="post-metadata">

### Author: ![BOUCUR](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/boucur/32/169053_2.png) [@BOUCUR](https://meta.discourse.org/u/BOUCUR)
#### Post date: [21 januari 2020 om 01:58 UTC](https://meta.discourse.org/t/provide-more-guidance-for-flag-actions-on-review-page/139052/7 "2020-01-21T01:58:32Z")

</div>

Thanks for your response!

> [@jomaxro](#):
>
> The `...` is the indication. Any button with `...` will not take immediate action,

As punctuation, it’s easily glossed over. Usually an indication of “More options” on a button is a stemless arrow, or if it is the ellipsis, styled differently to help indicate “something is here!” 🙂

 ![image](https://global.discourse-cdn.com/meta/original/3X/c/7/c71a68f0ef4645eab971bbc1074e18be58311898.png)

![image](https://global.discourse-cdn.com/meta/original/3X/f/b/fbb40e3578c479a641b8f71f4a1bde532ebdf10c.png)

> [@jomaxro](#):
>
> Also, just to check, queue posts and queued users don’t cause any confusion for your staff, right? Those reviewables are a bit clearer:

Approve/Delete User seems clear to me (though I don’t recognize that screen / don’t think we have a queued users setting turned on on our forum. I am just a volunteer moderator, not part of the admin/staff). For the queued posts, yep, specifying “Delete User” is helpful there to distinguish from the other options.
