Page MenuHomePhabricator

Audit tooltips and pop ups we display in the app and when they are displayed
Open, MediumPublic2 Estimated Story Points

Assigned To
Authored By
Seddon
Jul 14 2025, 3:57 PM
Referenced Files
F65534577: image_rec_1.png
Jul 21 2025, 2:58 PM
F65534542: vandalism_onboarding_2.png
Jul 21 2025, 2:58 PM
F65534541: vandalims_oboarding_1.png
Jul 21 2025, 2:58 PM
F65534485: description_tutorial_3.png
Jul 21 2025, 2:58 PM
F65534486: description_tutorial_2.png
Jul 21 2025, 2:58 PM
F65534487: description_tutorial_1.png
Jul 21 2025, 2:58 PM
F65534453: discover_list.png
Jul 21 2025, 2:58 PM
F65243514: remove_selected_language.png
Jul 18 2025, 8:47 PM

Description

We've previously audited tooltips and pop ups as part of T301426.

Since then we've added a bunch of new features with new cards, tooltips and pop ups. We should update our audit.

The Task
Review our code to share when we see what tooltips and pop up prompts

Must haves
A list of our current tooltips and pop up prompts and when they are triggered written in a way easy for the PM and Designer to comprehend

User Stories
As the PM for Android, I want to know what tool tips or pop ups exist in the app and when they are triggered, so that I can understand the current user journey and map a new one

Event Timeline

Dbrant set the point value for this task to 2.Jul 17 2025, 5:13 PM

Tooltips
1. Customize Toolbar
Frequency: once when user enters the article screen for first time
Invokes From: Article Screen
Number of tooltips: 1
Does not require login

customize_toolbar.png (1×1 px, 932 KB)

2. Image Recommendations
Frequency: Once
Invokes From: image recommendations screen
Number of tooltips: 3 appears in sequence
requires login

image_recommendations_1.png (1×1 px, 699 KB)
image_recommendations_2.png (1×1 px, 754 KB)
image_recommendations_3.png (1×1 px, 567 KB)
123

3. Suggested edits sequential tooltips
Frequency: Once, every time you long press Description Text
Invokes From: Suggested edits screen and Long press on Description Text (which are the actual stats number)
Number of tooltips: 4 appears in sequence
requires login

set_1.png (1×1 px, 113 KB)
set_2.png (1×1 px, 124 KB)
set_3.png (1×1 px, 128 KB)
set_4.png (1×1 px, 128 KB)
1234

4. Edit Patrol Screen initial tooltips
Frequency: Once
Invokes From: Edit Patrol Screen
Number of tooltips: 2 appears in sequence
requires login

vandalism_edit_patrol.png (1×1 px, 130 KB)
vandalism_edit_patrol_2.png (1×1 px, 117 KB)
12

5. Edit Patrol Screen "Reporting" tooltip
Frequency: Once
Number of tooltips: 1
requires login
Invokes From the following:

a. Problem with feature Menu Option
After reporting a problem with a feature and choosing "Satisfied", the tooltip appears reminding that feedback can be given anytime.

b. Watch or Unwatch Button in Bottom Navigation Tab
When the user interacts with this button and chooses "Satisfied" on the feedback form, tooltip appears.

c. Thank Button in Bottom Navigation Tab
Upon choosing "Satisfied" in the feedback form after using the Thank button, tooltip appears.

d. Undo or Redo
Upon choosing "Satisfied" in the feedback form after selecting either Undo or Redo popup, this tooltip appears

e. Changing Watchlist Expiry
When the user changes the expiry and chooses "Satisfied", the tooltip appears.

f. Feedback Form When Not Choosing "Satisfied"
If the user doesn't select "Satisfied" but still completes the feedback form, the tooltip appear after submission.

Tooltip
problem_with_feature.png (1×1 px, 132 KB)

5. Reading list screen tooltip
Frequency: Once
Invokes From: Reading list screen
Number of tooltips: 1
does not requires login

reading_list_tooltip.png (1×1 px, 469 KB)

Dialogs
1. Wikigames introduction dialog
Frequency: Shown once
Invoked From:

  • Either Article Screen – when the user opens an article for the first time
  • Or Explore Feed Screen – when the user opens the explore feed for the second time

(Only one of these triggers will show the dialog; the other will not)

wiki_game_in_article_screen.png (1×1 px, 155 KB)
wikigames_intro_dialog_explore_feed.png (1×1 px, 136 KB)
Article ScreenExplore Feed Screen

2. Reading list sync dialog

Scenarios:

  1. When reading list has been disabled from settings

Frequency: every time on manual sync

sync_disabled_from_settings.png (1×1 px, 127 KB)

  1. Logged-in users who haven’t interacted with the Reading List sync button in Settings

Invokes from:

  • Reading List screen,
  • article screen
  • explore feed
  • settings screen

Frequency & Behavior:

  • Shown every time the user manually syncs or adds an article, up to 3 times.
  • If the user logs in and a notification permission dialog appears, the sync dialog will be shown once, either on the Article screen or the Settings screen, whichever is opened first.
  • If the user has notifications enabled and logs in, the sync dialog will always

appear in the Explore Feed screen.

  • This dialog stops showing once the user disables sync from Settings
direct_communication_with_user_for_enabling_sync.png (1×1 px, 116 KB)
direct_article_screen.png (1×1 px, 168 KB)
direct_explore_feed.png (1×1 px, 149 KB)
manual syncarticle screenexplore feed

3. Unsupported Chinese Variant language
Invokes from: Explore Feed Screen
Frequency: one time
Scenarios: **

  1. When user selects language as a secondary language

unsupported_lang_variant_as_secondary.png (1×1 px, 144 KB)

  1. When user selects language as a primary language

unsupported_language_variant_as_primary.png (1×1 px, 155 KB)

4. Subscribe to topics
Invokes from: Talk page screen
Frequency: when logged out user subscribe to topics in talk page

subscribe_talk_page.png (1×1 px, 143 KB)

5. Edit conflict
Invokes from: Edit Article screen
Frequency: if there is a conflicting edits with other user

edit_conflict_editing.png (1×1 px, 113 KB)

6. talk page edit source
Invokes from: Edit Screen for Talk Page
Frequency: appears every time unless you check the "don't show again" box

talk_page_edit.png (1×1 px, 106 KB)

7. create account without email
Invokes from: Create Account Screen
Frequency: appears if user tries to create account without an email

create_acc_without_email.png (1×1 px, 120 KB)

8. clear browsing history
Invokes from: History Screen
Frequency: appears if user tries to clear their browsing history

clear_browsing_history.png (1×1 px, 97 KB)

9. max anon editing limit for adding article description
Invokes from: Article Screen
Frequency: appears after anon user edits for 5 times

anon_limit.png (1×1 px, 1002 KB)

10. thank you dialog in edit
Invokes from: Edit Patrol Screen
Frequency: appears when user taps the Thank button
requires login

thank_you_dialog.png (1×1 px, 140 KB)

11. rollback edits
Invokes from: Edit Patrol Screen
Frequency: appears when user selects the rollback menu option
requires login

rollbacks_edit.png (1×1 px, 131 KB)

12. Exiting edits without saving
Invokes from: Article Edit Screen
Frequency: appears when user tries to leave the edit screen without saving

edit_Screen_exiting_without_saving.png (1×1 px, 108 KB)

13. Edit Preview exiting without saving
Invokes from: Edit Preview Screen (internal, external links or diff links), does not appear when back button is tapped
Frequency: appears when user leaves the edit preview screen without saving

edit_preview_exiting_without_saving.png (1×1 px, 113 KB)

14. Undo edits
Invokes from: Edit Patrol Screen
Frequency: appears when user selects "Undo" from the menu option
requires login

undo_edits_patrol_screen.png (1×1 px, 127 KB)

15. Language selection
Invokes from: Explore Feed Screen or customize explore feed setting screen
Frequency: appears when user tries to edit card languages from each feed card or taps language code in the customize explore feed setting screen

lang_select_explore_feed.png (1×1 px, 138 KB)
lang_select_configure_feed_screen.png (1×1 px, 132 KB)
Featured card explore feed screenCustomize Explore Feed Screen

16. Logged out user tries to edit or reply
Invokes from: Edit Article Screen or Talk Page
Frequency: one time

user_not_logged_in_tries_to_edit.png (1×1 px, 127 KB)
reply_not_logged_in.png (1×1 px, 110 KB)

16. Temporary account
Invokes from: Edit Article Screen or Talk page
Frequency: one time after user makes an edit or tries to reply in talk page without account and tries to edit again next time

user_not_logged_in_tries_to_edit.png (1×1 px, 127 KB)
reply_temp_account.png (1×1 px, 159 KB)

17. Article appearing in multiple list
Invokes from: Reading List Screen
Frequency: Appears when the user turns off offline mode for an article that exists in multiple lists.

article_appears_in_multiple_list_1.png (1×1 px, 527 KB)

18. Download using mobile data
Invokes from: Reading List Screen
Frequency: Appears when the user tries to download over mobile data when "only download using wifi" is turned on in the settings

dowload_using_mobile_data.png (1×1 px, 130 KB)

18. Remove sync reading list from setting screen
Invokes from: Settings Screen
Frequency: when user tries to disable sync reading list

remove_sync_reading_list_from_settings.png (1×1 px, 164 KB)

19. Vanish Account
Invokes from: Settings Screen
Frequency: when user tries to delete account

vanish_account.png (1×1 px, 159 KB)

20. Remove language
Invokes from: Language screen
Frequency: when user tries to delete language

remove_selected_language.png (1×1 px, 88 KB)

Cards

Discover list onboarding card
Invokes from: Reading Lists Screen
Frequency: continues to appear until the user either completes the discover list flow or skips it by selecting "No Thanks"

discover_list.png (1×1 px, 82 KB)

Edits Description Tutorial pages
Invokes from: Suggested Edit Task Card from Explore Feed Screen
Frequency: once
requires login

description_tutorial_1.png (1×1 px, 150 KB)
description_tutorial_2.png (1×1 px, 121 KB)
description_tutorial_3.png (1×1 px, 89 KB)

Vandalism Onboarding
Invokes from: when users taps Edit Patrol card from Suggested Edits Screen for first time
Frequency: once
requires login

vandalims_oboarding_1.png (1×1 px, 104 KB)
vandalism_onboarding_2.png (1×1 px, 124 KB)

Image Recommendation Onboarding
Invokes from: when users taps "Article Images" from Suggested Edits Screen for first time
Frequency: once
requires login

image_rec_1.png (1×1 px, 139 KB)

Changes since last audit

  1. The tooltip that appeared after staying on the article for 2 seconds has been removed.
  2. The tooltip that appeared below the notification icon in the article screen has been removed.
  3. Tooltip for multilingual search has been removed.
  4. Watchlist tooltip on the main screen has been removed.
  5. Watchlist tooltip on article screen has been removed.
  6. Remove Chinese Variant dialog has been removed.
JTannerWMF added subscribers: WRai-WMF, JTannerWMF.

Thanks William! Sarah is going to make suggestions of changes from here.