[SPIKE] Investigate technical feasibility of surfacing "Add an image" suggestions within Suggestion Mode
Closed, ResolvedPublic
Actions

Assigned To

Authored By

	ppelberg
	Dec 11 2025, 5:35 AM

Description

This task involves the work of investigating what technical work would be involved in surfacing Add an image suggestions within the VisualEditor's Suggestion Mode.

Learning objectives

1. What technical work would need to be done to enable the experience described in Requirements below?
2. What (if any() technical work would the Editing Team need to depend on other teams to complete?
3. What level of effort/complexity would you assign to the technical work the Editing Team would need to take on to enable the experience described in Requirements below?

Requirements

For the purposes of this investigation, surfacing "Add an image" suggestions within Suggestion Mode would result in the following user experience:

When people open the visual editor on a wiki where they've enabled Suggestion Mode and an "Add an image" suggestion is available
Present that image suggestion in the way that all other suggestions are surfaced in Suggestion Mode
- E.g. presented in the side-rail (desktop) and gutter (mobile), using a card design that is consistent with other suggestions, with the content the suggestion is relevant to highlighted, etc.

NOTE: "Add an image" suggestions surfaced in Suggestion Mode would need to use the same configuration settings that volunteers have already set at that wiki for "Add an image"

Done

Answers to all "Learning objectives" are documented on this ticket

Related Objects
Search...

Status	Assigned	Task
Open	None	T360489 [EPIC] Generate and present edit suggestions at scale
Open	None	T414853 [MILESTONE] Deploy Suggestion Mode as a default-on feature.
Open	None	T404600 [MILESTONE] Run controlled experiment of Suggestion Mode MVP
Resolved	ppelberg	T412332 [SPIKE] Investigate technical feasibility of surfacing "Add an image" suggestions within Suggestion Mode

Event Timeline

ppelberg created this task.Dec 11 2025, 5:35 AM

ppelberg edited projects, added Editing-team (Kanban Board); removed Editing-team (Planning).Dec 16 2025, 5:45 PM

ppelberg updated the task description. (Show Details)

ppelberg moved this task from Inbox to Ready to Be Worked On on the Editing-team (Kanban Board) board.

ppelberg updated the task description. (Show Details)

ppelberg updated the task description. (Show Details)Jan 13 2026, 6:46 PM

ppelberg edited projects, added Editing-team (Editing-19Jan-30Jan-2026); removed Editing-team (Kanban Board).Jan 22 2026, 12:47 AM

ppelberg moved this task from Decisions to be made to Ready to Be Worked On on the Editing-team (Editing-19Jan-30Jan-2026) board.

Our technical dependency would be an API endpoint from Growth that could tell us which images in which sections to suggest for a given article.

From there, showing a check card wouldn't be too hard, but most of the complexity is in the add-image workflow, as the image will be inserted without a caption. We have a few options:

Place the cursor inside the empty caption and hope the user fills it out
Show an "empty image caption" edit check after inserting the image
Come up with a completely custom guided workflow like Growth uses, although I think this goes against our principle of building checks in a scalable and easy to maintain manner.

In T412332#11548924, @Esanders wrote:

Our technical dependency would be an API endpoint from Growth that could tell us which images in which sections to suggest for a given article.

From there, showing a check card wouldn't be too hard, but most of the complexity is in the add-image workflow, as the image will be inserted without a caption. We have a few options:

Place the cursor inside the empty caption and hope the user fills it out

Show an "empty image caption" edit check after inserting the image

Come up with a completely custom guided workflow like Growth uses, although I think this goes against our principle of building checks in a scalable and easy to maintain manner.

Wonderful. Thank you, Ed. I've translated these learnings into the newly-created T416043.

ppelberg mentioned this in T416530: [SPIKE] Investigate technical feasibility of surfacing Reference Score suggestions within Suggestion Mode.Wed, Feb 4, 10:08 PM

[SPIKE] Investigate technical feasibility of surfacing "Add an image" suggestions within Suggestion ModeClosed, ResolvedPublicActions