Help:Growth/Tools/Add an image

Growth Features Use the tools Updates Projects Growth Team
Browse all contents
Discover the existing Features Help pages and resources around the Features Project's last news Current initiatives and strategic thinking about building the Features or creating resources. Who we are

General help and resources

Help resources for mentors Help resources for communities
The following procedure is only applicable where Image recommendation is available.
Onboarding image of "Add an image" tool, where a robot wants to add a picture of the Moon to the article "Moon".

Add an image allows users to add an image and an appropriate caption to a Wikipedia article. These images suggestions should generally be accurate. However, some suggestions may be unsuitable for the article. As a user, your role is to determine if the image is the right one, depending on the context.

Where can I find these images?

"Add a image" has been added to the wikis starting in December 2021.

"Add a image" is available on both mobile and desktop. As other Growth features, "Add a image" is not available on Android and iOS apps.

These images can be found on the Homepage.

Let us know if you have any question or feedback about this tool.

How does this system work?

Images are suggested by a machine. And machines aren't perfect!

You will decide whether a suggested image should be put in a Wikipedia article. Suggestions are machine-generated, and some of them can be incorrect. You will use your judgment to decide whether to accept or reject them.

For each article, we provide one image to review. Two different tasks can be suggested:

  • Add an image to an unillustrated article suggests a image to an article without any image.
  • Add an image to an article section suggests a image to an article that already has images, but where a given part of the article has no image.

After you accept an image, you'll write a short caption, and then you can publish your edit.

How to add images

Step 1
Go to your Homepage
The homepage is the central place where are all other Suggested edits.
Step 2
If not already done, enable "Suggested edits".
Step 3
In Suggested Edits, select "Add an image to an unillustrated article".
At some wikis, you can also select "Add an image to an article section".
You can select the topic you want to work on.
Step 4
Find an article you'd like to work on.
Explanation of "Add a image"
Step 5
The article opens in "Suggested edits" mode.
You will see a small explanation panel, that summarizes how "Add a image" work.
Step 6
It is time to choose if the suggested image should be added.
Have a good look at the article, to know more about its topic.
Use the filename, description, and the reason it was suggested to help you decide if it should be placed in the article.
The step where the image is reviewed, in Spanish language.
Step 7
Review the image carefully.
Read over the article and think about whether the suggested image will help readers understand the content. Is it appropriate to display in the article?
You have the following choices for the image:
  • yes (it will add the image)
  • no (it won't add the image)
  • I don't know (it won't add the image)
If you click on "no" or "I don't know", you will be asked why the image is not the right fit. This way, we can improve suggestions.
Step 8
Add a caption
Write a brief description showing why this image is relevant to the article.
Adding a caption is mandatory.
This caption will appear below the image.
  • Review the image details to find information that is relevant to include. It could be a date, a location, a detail in the picture, etc.
  • Describe the image in a way that makes it clear how it relates to the article. Write the caption using your own words.
  • Avoid adjectives such as "good", "ugly" or "pretty" to be neutral.
  • Write in the language of the article.
Step 9
Review and save
When you have added the caption to the image, click on "Publish changes…". A summary is displayed.
If you are satisfied with your choice, click again on "Publish changes…"
If you want to change your caption, click on the cross.
If you want to see how the image is inserted into the article's body, click on "Review your changes".
You have successfully added an image to Wikipedia!
Your edit is immediately visible in Wikipedia's recent changes page. It has been tagged as a Suggested Edit.


These features are available for new accounts. Older accounts need to enable the Homepage and the Help panel in their preferences. Discover how to enable these features.

At the moment, this feature is only available for some users (A/B test). A way to get Add an image to your account is provided for users willing to test the feature.

Learn more

Images are suggested because they are used at other versions of Wikipedia, or because they are used on the article's Wikidata item.

"Add a image" is part of the "Structured tasks" project, from the Growth team.

Add a image adds a new standard way to edit the wikis. Before, users could use "wikitext editing" or "visual editing". Add a image adds a new edit mode "suggested editing".

To learn more about the project, and the system that finds images to suggest, please visit the project page.