Page MenuHomePhabricator
Create Task
Maniphest T417827

Suggestion Mode: Implement contextual Toasts to communicate state changes
Open, In Progress, Needs TriagePublic3 Estimated Story Points
Actions

Description

Background

As part of the usability testing conducted for T414518, we identified that contextual Toast feedback significantly improves clarity and user confidence when interacting with Suggestion Mode. Toasts were not part of the original scope of T414518, but testing clearly showed they:

  • Reinforce system state changes (on/off)
  • Clarify when new suggestions become available
  • Confirm when all suggestions have been resolved
  • Reduce ambiguity and cognitive load
  • Improve perceived control

This task aims to implement Toast feedback for key state changes in Suggestion Mode to ensure a consistent and clear experience while finding and completing suggestions.

User stories

  • As a user, when I turn suggestions on or off, I want confirmation that the system state has changed, so that I feel confident in what is currently visible.
  • As a user, when loading the full-page on mobile, I want to be clearly informed that more suggestions are now available so I can complete/decline them.
  • As a user, when I resolve the last suggestion, I want confirmation that there are no more suggestions left, so that I don’t continue searching unnecessarily.

Toasts to implement

Implement auto-dismiss Toasts for the following cases:

  1. When turning Suggestions are turned on → "Suggestions turned on" or "No suggestions available" (in both desktop + mobile)
  2. When turning Suggestions are turned off → "Suggestions turned off” (in both desktop + mobile)
  3. When loading the full page on mobile and more suggestions become available → “More suggestions are now available” (just on mobile, after clicking on the "Edit full-page" button)
  4. When completed/declined all suggestions available in the article, or if an article/section doesn't include any suggestion → “No more suggestions left.” (in both desktop + mobile)
image.png (4,336×2,440 px, 750 KB)
image.png (2,880×2,016 px, 891 KB)
mobiledesktop

Open questions

Add here the questions to be answered in order to design and implement the component

Acceptance criteria (or Done)

  • Implement the Toasts listed in the task in both desktop and mobile

Details

Related Changes in Gerrit:
SubjectRepoBranchLines +/-
EditCheck: Simplify suggestions-toggle toastsmediawiki/extensions/VisualEditormaster+8 -44
EditCheck: Simplify suggestions-toggle toastsmediawiki/extensions/VisualEditormaster+8 -44
Show notifications when interacting with suggestionsmediawiki/extensions/VisualEditormaster+65 -5
Customize query in gerrit

Related Objects
Search...

Event Timeline

bmartinezcalvo created this task.Feb 18 2026, 8:19 PM
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptFeb 18 2026, 8:19 PM
bmartinezcalvo mentioned this in T415933: Conduct usability study: First suggestion discoverability when entering Edit mode regardless of viewport position.Feb 18 2026, 8:20 PM
bmartinezcalvo mentioned this in T414518: Suggestion Mode: Ensure first suggestion discoverability when entering Edit mode regardless of viewport position.Feb 18 2026, 8:48 PM
bmartinezcalvo mentioned this in T420268: Implement Suggestion Mode Toggle (v0.2).Mar 17 2026, 12:16 PM
ppelberg added a parent task: T415589: [EPIC] Suggestion Mode: Introduce way to toggle Suggestion Mode ON/OFF.Mar 17 2026, 6:08 PM
ppelberg edited projects, added: Editing-team (Editing-Q4-30Mar-10Apr-2026); removed: Editing-team.Mar 17 2026, 6:10 PM
bmartinezcalvo mentioned this in T415926: Conduct usability study: Mobile edit toolbar improvements.Mar 20 2026, 3:57 PM
ppelberg edited parent tasks, added: T420419: Implement Suggestion Mode Toggle (mobile); removed: T415589: [EPIC] Suggestion Mode: Introduce way to toggle Suggestion Mode ON/OFF.Mar 20 2026, 8:50 PM
ppelberg moved this task from Backlog to Meta on the VisualEditor Suggestion Mode board.Mar 27 2026, 7:54 PM
ppelberg moved this task from Decision to be made to Ready to Be Worked On on the Editing-team (Editing-Q4-30Mar-10Apr-2026) board.Mar 27 2026, 10:55 PM
bmartinezcalvo updated the task description. (Show Details)Mar 30 2026, 10:39 AM
ppelberg edited projects, added: Editing-team; removed: Editing-team (Editing-Q4-30Mar-10Apr-2026).Mar 30 2026, 6:43 PM
ppelberg moved this task from Untriaged to Editing-Q4-2025-2026 on the Editing-team board.
Sdkb mentioned this in T422949: Improve Suggestion Mode toggle display for articles with no suggestions available.Apr 10 2026, 3:08 PM
ppelberg edited projects, added: Editing-team (Editing-Q4-13Apr-24Apr-2026); removed: Editing-team.Apr 10 2026, 11:39 PM
ppelberg moved this task from Decision to be made to Ready for Dev on the Editing-team (Editing-Q4-13Apr-24Apr-2026) board.
bmartinezcalvo moved this task from Incoming to Done on the Design board.Apr 13 2026, 5:13 PM
VPuffetMichel set the point value for this task to 3.Apr 13 2026, 5:17 PM
Esanders subscribed.Apr 13 2026, 5:19 PM

Mobile toast appears at the bottom of the page. We can file a separate task to look into moving it up to avoid keyboard clash.

bmartinezcalvo added a comment.Apr 14 2026, 7:47 AM
El T417827#11815897, @Esanders escribió:

Mobile toast appears at the bottom of the page. We can file a separate task to look into moving it up to avoid keyboard clash.

Task created T423233.

bmartinezcalvo mentioned this in T422979: Ensure first suggestion discoverability when it's outside the current section being edited on mobile.Apr 15 2026, 9:43 AM
Esanders changed the task status from Open to In Progress.Apr 15 2026, 11:44 AM
Esanders claimed this task.
Esanders moved this task from Ready for Dev to Dev Doing on the Editing-team (Editing-Q4-13Apr-24Apr-2026) board.
gerritbot added a comment.Apr 15 2026, 12:21 PM

Change #1271696 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/VisualEditor@master] Show notifications when interacting with suggestions

https://gerrit.wikimedia.org/r/1271696

gerritbot added a project: Patch-For-Review.Apr 15 2026, 12:21 PM
Esanders moved this task from Dev Doing to Code review on the Editing-team (Editing-Q4-13Apr-24Apr-2026) board.Apr 17 2026, 11:19 AM
Esanders moved this task from Code review to Design review on the Editing-team (Editing-Q4-13Apr-24Apr-2026) board.
PatchDemoBot added a comment.Apr 17 2026, 11:22 AM

Test wiki created on Patch demo by ESanders (WMF) using patch(es) linked to this task:
https://1cb7ea69ff.catalyst.wmcloud.org/wiki/Regent's Park?veaction=edit&ecenable=experimental

bmartinezcalvo added a comment.Apr 20 2026, 11:34 AM

@Esanders I've reviewed the implemented Toasts in both desktop and mobile and they look good.

I've just a couple of observations about the 0 suggestions one:

  • Copy: I wonder if "No more suggestions available" would be better than "No more suggestions left"
  • Behavior: related to T422949, when users turn on suggestions and none are available, it may be clearer to show a “No suggestions available for now” Toast instead of “Suggestions turned on” as it better explains what users will find.
gerritbot added a comment.Apr 21 2026, 12:39 AM

Change #1271696 merged by jenkins-bot:

[mediawiki/extensions/VisualEditor@master] Show notifications when interacting with suggestions

https://gerrit.wikimedia.org/r/1271696

ReleaseTaggerBot added a project: MW-1.46-notes (1.46.0-wmf.26; 2026-04-28).Apr 21 2026, 1:00 AM
Maintenance_bot removed a project: Patch-For-Review.Apr 21 2026, 1:32 AM
Esanders edited projects, added: Editing-team (Editing-Q4-27Apr-8May-2026); removed: Editing-team (Editing-Q4-13Apr-24Apr-2026).Apr 27 2026, 1:17 PM
Esanders moved this task from Decision to be made to Design review on the Editing-team (Editing-Q4-27Apr-8May-2026) board.Apr 28 2026, 10:37 AM
Esanders moved this task from Design review to QA on the Editing-team (Editing-Q4-27Apr-8May-2026) board.Apr 28 2026, 10:40 AM
In T417827#11838505, @bmartinezcalvo wrote:

@Esanders I've reviewed the implemented Toasts in both desktop and mobile and they look good.

I've just a couple of observations about the 0 suggestions one:

  • Copy: I wonder if "No more suggestions available" would be better than "No more suggestions left"
  • Behavior: related to T422949, when users turn on suggestions and none are available, it may be clearer to show a “No suggestions available for now” Toast instead of “Suggestions turned on” as it better explains what users will find.

Sounds good. I'd change "No suggestions available for now" to "No suggestions available yet"

gerritbot added a comment.Apr 28 2026, 10:49 AM

Change #1278392 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/VisualEditor@master] EditCheck: Update toast copy

https://gerrit.wikimedia.org/r/1278392

gerritbot added a project: Patch-For-Review.Apr 28 2026, 10:49 AM
Esanders moved this task from QA to Code review on the Editing-team (Editing-Q4-27Apr-8May-2026) board.Apr 28 2026, 10:49 AM
bmartinezcalvo added a comment.Apr 28 2026, 11:05 AM
El T417827#11865127, @Esanders escribió:
In T417827#11838505, @bmartinezcalvo wrote:

@Esanders I've reviewed the implemented Toasts in both desktop and mobile and they look good.

I've just a couple of observations about the 0 suggestions one:

  • Copy: I wonder if "No more suggestions available" would be better than "No more suggestions left"
  • Behavior: related to T422949, when users turn on suggestions and none are available, it may be clearer to show a “No suggestions available for now” Toast instead of “Suggestions turned on” as it better explains what users will find.

Sounds good. I'd change "No suggestions available for now" to "No suggestions available yet"

@Esanders agree on this copy change.

ppelberg moved this task from Code review to Blocked on the Editing-team (Editing-Q4-27Apr-8May-2026) board.May 4 2026, 9:04 PM

Per offline discussion with @bmartinezcalvo on 20 April 2026, toasts ought to be limited to the following cases for now:

CaseToast copyNotes
Turn Suggestion Mode OFFSuggestions turned off
Turn Suggestion Mode ON when ≥1 suggestions are available within the articleSuggestions turned on
Turn Suggestion Mode ON when 0 suggestions are available within the articleNo suggestions available

Said another way, toasts should ❌ NOT ❌ appear in the following cases:

CaseToast copyNotes
When loading the full page on mobile and more suggestions become availableN/A
When completed/declined all suggestions available in the article, or if an article/section doesn't include any suggestionN/A

These changes are in service of:

  1. Ensuring people clearly understand when Suggestion Mode is ON/OFF and, relatedly, what the effect is of tapping the 💡 button
  2. Creating a relatively distraction-free environment for people to edit within and add feedback/interaction when the absence of such creates confusion
ppelberg updated the task description. (Show Details)May 4 2026, 9:05 PM
ppelberg updated the task description. (Show Details)
gerritbot added a comment.May 6 2026, 12:23 PM

Change #1283740 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/VisualEditor@master] EditCheck: Simplify suggestions-toggle toasts

https://gerrit.wikimedia.org/r/1283740

Esanders updated the task description. (Show Details)May 6 2026, 12:25 PM
gerritbot added a comment.May 6 2026, 3:44 PM

Change #1283740 abandoned by Esanders:

[mediawiki/extensions/VisualEditor@master] EditCheck: Simplify suggestions-toggle toasts

https://gerrit.wikimedia.org/r/1283740

bmartinezcalvo updated the task description. (Show Details)May 8 2026, 9:27 AM
gerritbot added a comment.May 11 2026, 4:56 PM

Change #1278392 merged by jenkins-bot:

[mediawiki/extensions/VisualEditor@master] EditCheck: Simplify suggestions-toggle toasts

https://gerrit.wikimedia.org/r/1278392

ReleaseTaggerBot added a project: MW-1.47-notes (1.47.0-wmf.2; 2026-05-12).May 11 2026, 5:00 PM
Maintenance_bot removed a project: Patch-For-Review.May 11 2026, 5:31 PM
ppelberg removed Esanders as the assignee of this task.May 11 2026, 5:47 PM
ppelberg edited projects, added: Editing QA; removed: Editing-team (Editing-Q4-27Apr-8May-2026).
ppelberg mentioned this in T425595: [EPIC] Resolve outstanding UX issues/improvements post-experiment start.May 12 2026, 5:49 AM
PatchDemoBot added a comment.Tue, May 19, 11:13 AM

Test wiki on Patch demo by ESanders (WMF) using patch(es) linked to this task was deleted:

https://1cb7ea69ff.catalyst.wmcloud.org/wiki/Regent's Park?veaction=edit&ecenable=experimental

Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL · Credits