<!--
Copyright 2021 The Chromium Authors
Use of this source code is governed by a BSD-style license that can be
found in the LICENSE file.
-->

<!--
This file is used to generate a comprehensive list of histograms related to
feature engagement along with a detailed description for each histogram.

For best practices on writing histogram descriptions, see
https://chromium.googlesource.com/chromium/src.git/+/HEAD/tools/metrics/histograms/README.md

Please follow the instructions in the OWNERS file in this directory to find a
reviewer. If no OWNERS file exists, please consider signing up at
go/reviewing-metrics (Googlers only), as all subdirectories are expected to
have an OWNERS file. As a last resort you can send the CL to
chromium-metrics-reviews@google.com.
-->

<histogram-configuration>

<histograms>

<variants name="IPHDatabase">
  <variant name="AvailabilityStore" summary="Availability store"/>
  <variant name="EventStore" summary="Event store"/>
</variants>

<variants name="IPHFeature">
  <variant name="IPH_AccountSettingsHistorySync"
      summary="educate users about the history opt-in toggle in account
               settings on Android"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_AddToBookmarks"
      summary="the add to bookmarks adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_Glic"
      summary="the glic button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_NewTab"
      summary="the new tab adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_PageSummary_Pdf"
      summary="the analyze pdf adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_PageSummary_Web"
      summary="the web page summary adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_ReadAloud"
      summary="the Read Aloud adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_Share"
      summary="the share adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_Translate"
      summary="the translate adaptive button in the top toolbar"/>
  <variant name="IPH_AdaptiveButtonInTopToolbarCustomization_VoiceSearch"
      summary="the voice search adaptive button in the top toolbar"/>
  <variant name="IPH_AddToHomescreenMessage"
      summary="educating users about adding website shortcuts to their home
               screen (using a message UI)"/>
  <variant name="IPH_AddToHomescreenTextBubble"
      summary="(obsolete) educating users about adding website shortcuts to
               their home screen (using a text bubble)"/>
  <variant name="IPH_AimActivationHint"
      summary="A hint to activate AI Mode on Android Desktop via keystrokes."/>
  <variant name="IPH_AndroidBottomBarAim"
      summary="Describes the AI Mode button added in the bottom bar."/>
  <variant name="IPH_AndroidBottomBarAimPromoDialog"
      summary="For the promo dialog shown to introduce AI Mode with the
               bottom bar."/>
  <variant name="IPH_AndroidBottomBarGlic"
      summary="Describes the GLIC button added in the bottom bar."/>
  <variant name="IPH_AndroidBottomBarNewTab"
      summary="Describes the new tab button moved down in the bottom bar."/>
  <variant name="IPH_AndroidBottomBarPromoDialog"
      summary="Describes the promo dialog shown to introduce the bottom bar."/>
  <variant name="IPH_AndroidTabDeclutter"
      summary="Shows how to access tabs which have been archived."/>
  <variant name="IPH_AndroidVerticalTabsPromo"
      summary="Vertical Tabs promo on Android horizontal tab strip."/>
  <variant name="IPH_AppRatingPrompt" summary="App Rating Prompt action"/>
  <variant name="IPH_AppSpecificHistory" summary="App Specific History action"/>
  <variant name="IPH_AutoDarkOptOut"
      summary="educating users about disabling auto dark feature globally"/>
  <variant name="IPH_AutoDarkUserEducationMessage"
      summary="message educating users about disabling auto dark web contents
               feature globally"/>
  <variant name="IPH_AutoDarkUserEducationMessageOptIn"
      summary="message educating users about enabling auto dark web contents
               feature globally"/>
  <variant name="IPH_AutofillAccountNameEmailSuggestion"
      summary="message shown along with the account name and email suggestion
               option in the Autofill dropdown"/>
  <variant name="IPH_AutofillAiOptIn"
      summary="snooze educating users about the possibility of turning on the
               AutofillAi feature"/>
  <variant name="IPH_AutofillAiValuables"
      summary="snooze educating users about the possibility of autofilling
               Google Wallet passses"/>
  <variant name="IPH_AutofillAtMemory"
      summary="message shown when users copy/paste a value from another tab
               educating them that they can use the Autofill AtMemory feature
               instead"/>
  <variant name="IPH_AutofillBnplAffirmOrZipSuggestion"
      summary="message shown when users see the Autofill BNPL chip to educate
               users that they can now pay over time using Affirm or Zip."/>
  <variant name="IPH_AutofillBnplAffirmZipOrKlarnaSuggestion"
      summary="message shown when users see the Autofill BNPL chip to educate
               users that they can now pay over time using Affirm, Zip, or
               Klarna."/>
  <variant name="IPH_AutofillCardInfoRetrievalSuggestion"
      summary="message shown in the Autofill dropdown to educate users that a
               card info retrieval card appears because their account with
               their issuer was linked to their Google Pay account."/>
  <variant name="IPH_AutofillCreditCardBenefit"
      summary="message shown in the Autofill dropdown to educate users on the
               existence of credit card benefits."/>
  <variant name="IPH_AutofillDisabledVirtualCardSuggestion"
      summary="message shown along with a disabled and grayed-out virtual
               card suggestion in the autofill suggestion list indicating
               that the merchant has opted-out of accepting virtual cards."/>
  <variant name="IPH_AutofillDownstreamCardAwareness"
      summary="message shown alongside the Autofill dropdown to educate users
               that an externally-saved card can be used in Chrome."/>
  <variant name="IPH_AutofillEnableLoyaltyCards"
      summary="toast educating users about the possibility of autofilling
               loyalty cards"/>
  <variant name="IPH_AutofillExternalAccountProfileSuggestion"
      summary="message shown along with the externally created (e.g. in
               Google Pay) profile suggestion option in the Autofill dropdown"/>
  <variant name="IPH_AutofillHomeWorkProfileSuggestion"
      summary="message shown along with the home and work profile suggestion
               option in the Autofill dropdown"/>
  <variant name="IPH_AutofillOmniboxPaymentChip"
      summary="the Autofill payment omnibox page action chip"/>
  <variant name="IPH_AutofillVirtualCardCVCSuggestion"
      summary="message shown to users that have saved a virtual card on an
               online merchant website to educate users on how to fill in
               their virtual card verification code"/>
  <variant name="IPH_AutofillVirtualCardSuggestion"
      summary="message shown along with the virtual card suggestion option in
               the Autofill dropdown to educate users virtual cards come with
               better security"/>
  <variant name="IPH_AutofillWalletDirectOffers"
      summary="message shown when direct offers from Google Wallet are
               available for a merchant promo code field"/>
  <variant name="IPH_BackNavigationMenu"
      summary="educating users about the back navigation menu to navigate
               back more than one page at a time."/>
  <variant name="IPH_BadgedReaderMode"
      summary="What's New badge for Reading Mode"/>
  <variant name="IPH_BadgedReadingList" summary="badged reading list"/>
  <variant name="IPH_BatterySaverMode" summary="battery saver mode"/>
  <variant name="IPH_Bookmark" summary="bookmark"/>
  <variant name="IPH_BookmarkBarSimplified"
      summary="bookmark bar simplified auto-hide toast"/>
  <variant name="IPH_BottomToolbarTip" summary="bottom toolbar"/>
  <variant name="IPH_CCTHistory" summary="CCT history action"/>
  <variant name="IPH_CCTMinimized" summary="CCT minimize action"/>
  <variant name="IPH_ChromeDuet"
      summary="notifying users that search accelerator is at the bottom of
               the screen"/>
  <variant name="IPH_ChromeDuetHomeButton"
      summary="notifying users that home button has moved to the bottom of
               the screen"/>
  <variant name="IPH_ChromeDuetTabSwitcherButton"
      summary="notifying users that tab switcher button has moved to the
               bottom of the screen"/>
  <variant name="IPH_ChromeHomeExpand"
      summary="Chrome Home shown on cold start"/>
  <variant name="IPH_ChromeHomePullToRefresh"
      summary="Chrome Home shown after a pull-to-refresh"/>
  <variant name="IPH_CompanionSidePanel"
      summary="prompting users to view the companion feature in the side
               panel"/>
  <variant name="IPH_CompanionSidePanelRegionSearch"
      summary="prompting users to use the region search feature in the
               companion side panel"/>
  <variant name="IPH_ComposeMSBBSettingsFeature"
      summary="Prompting users to enable MSBB to use the compose feature."/>
  <variant name="IPH_ComposeNewBadgeFeature"
      summary="New badge shows in Autofill popup entry"/>
  <variant name="IPH_ContextualPageActions_PriceTracking"
      summary="contextual page price tracking action in the top toolbar"/>
  <variant name="IPH_ContextualPageActions_PriceTrackingActionChip"
      summary="action chip variant of contextual page price tracking action
               in the top toolbar"/>
  <variant name="IPH_ContextualSearchInPanelHelp"
      summary="promoting longpress from within the panel"/>
  <variant name="IPH_ContextualSearchOptIn"
      summary="opting-in to contextual search"/>
  <variant name="IPH_ContextualSearchPromotePanelOpen"
      summary="opening the contextual search panel"/>
  <variant name="IPH_ContextualSearchPromoteTap"
      summary="tap trigger for contextual search"/>
  <variant name="IPH_ContextualSearchTappedButShouldLongpress"
      summary="contextual search to help users that try to trigger the
               feature with a tap to long-press instead"/>
  <variant name="IPH_ContextualSearchTranslationEnable"
      summary="contextual search to help users enable our privacy policy in
               order to get better translations"/>
  <variant name="IPH_ContextualSearchWebSearch"
      summary="contextual search for users who use web search"/>
  <variant name="IPH_ContextualTasksEphemeralToolbarButton"
      summary="contextual tasks ephemeral toolbar button"/>
  <variant name="IPH_CriticalActionAppMenu"
      summary="educating users on the Chrome app menu where to view Gemini
               key browsing actions in history."/>
  <variant name="IPH_CriticalActionFilterChip"
      summary="educating users on chrome://history about the Gemini filter
               chip for viewing key browsing actions."/>
  <variant name="IPH_DataSaverDetail" summary="data saver detail"/>
  <variant name="IPH_DataSaverMilestonePromo"
      summary="data saver milestone promo"/>
  <variant name="IPH_DataSaverPreview" summary="data saver preview"/>
  <variant name="IPH_DefaultBrowserPromoMagicStack"
      summary="Default browser promo in Magic Stack"/>
  <variant name="IPH_DefaultBrowserPromoMessages"
      summary="Default browser promo with messages on omnibox paste"/>
  <variant name="IPH_DefaultBrowserPromoSettingCard"
      summary="Default browser promo in Chrome settings"/>
  <variant name="IPH_DefaultSiteView" summary="default site view info on iOS"/>
  <variant name="IPH_DesktopCustomizeChromeAutoOpen"
      summary="Customize Chrome Auto Open"/>
  <variant name="IPH_DesktopCustomizeChromeExperiment"
      summary="customizing new tab page"/>
  <variant name="IPH_DesktopPwaInstall" summary="desktop PWA install icon"/>
  <variant name="IPH_DesktopPWAsLinkCapturingLaunch"
      summary="PWA launch due to link capturing being enabled"/>
  <variant name="IPH_DesktopPWAsLinkCapturingLaunchAppInTab"
      summary="PWA launch due to link capturing being enabled"/>
  <variant name="IPH_DesktopRealboxContextualSearchFeature"
      summary="Desktop NTP contextual search"/>
  <variant name="IPH_DesktopSharedHighlighting"
      summary="Sharing links with highlighted text"/>
  <variant name="IPH_DiscardRing" summary="Discard ring for tabs"/>
  <variant name="IPH_DownloadEsbPromo" summary="download ESB promo"/>
  <variant name="IPH_DownloadHome" summary="download home"/>
  <variant name="IPH_DownloadInfobarDownloadContinuing"
      summary="download infobar informing that downloads are still in
               progress"/>
  <variant name="IPH_DownloadInfoBarDownloadsAreFaster"
      summary="download infobar informing that downloads are now faster than
               before"/>
  <variant name="IPH_DownloadPage" summary="download page"/>
  <variant name="IPH_DownloadPageScreenshot"
      summary="download page for screenshot"/>
  <variant name="IPH_DownloadSettings"
      summary="accessing download settings from download home"/>
  <variant name="IPH_DownloadToolbarButton" summary="download toolbar button"/>
  <variant name="IPH_EphemeralTab"
      summary="new label on the context menu for Ephemeral Tab"/>
  <variant name="IPH_ExplicitBrowserSigninPreferenceRemembered"
      summary="Confirmation message that the explicit browser signin
               preference was remembered"/>
  <variant name="IPH_ExploreSitesTile" summary="Explore Sites feature"/>
  <variant name="IPH_ExtensionsManageAppMenuFeature"
      summary="message shown informing users they can manage their extensions
               in the app menu."/>
  <variant name="IPH_ExtensionsManageToolbarFeature"
      summary="message shown informing users they can manage their extensions
               in the extensions menu found in the toolbar."/>
  <variant name="IPH_ExtensionsMenu" summary="extensions menu opened"/>
  <variant name="IPH_ExtensionsPinnedByDefault"
      summary="message shown informing users that extensions are pinned by
               default"/>
  <variant name="IPH_ExtensionsRequestAccessButton"
      summary="extensions request access button shown"/>
  <variant name="IPH_ExtensionsZeroStatePromo"
      summary="message shown anchored to the three dots app menu suggesting
               users with no extensions installed to explore the IPH_Chrome
               Web Store."/>
  <variant name="IPH_FeatureNotificationGuideDefaultBrowserNotificationShown"
      summary="(obsolete) feature notification guide default browser
               notification"/>
  <variant name="IPH_FeatureNotificationGuideDefaultBrowserPromo"
      summary="(obsolete) feature notification guide default browser promo"/>
  <variant name="IPH_FeatureNotificationGuideIncognitoTabHelpBubble"
      summary="(obsolete) feature notification guide incognito tab help
               bubble"/>
  <variant name="IPH_FeatureNotificationGuideIncognitoTabNotificationShown"
      summary="(obsolete) feature notification guide incognito tab
               notification"/>
  <variant name="IPH_FeatureNotificationGuideNTPSuggestionCardHelpBubble"
      summary="(obsolete) feature notification guide NTP suggestion card help
               bubble"/>
  <variant
      name="IPH_FeatureNotificationGuideNTPSuggestionCardNotificationShown"
      summary="(obsolete) feature notification guide NTP suggestion card
               notification"/>
  <variant name="IPH_FeatureNotificationGuideSignInHelpBubble"
      summary="(obsolete) feature notification guide sign in help bubble"/>
  <variant name="IPH_FeatureNotificationGuideSignInNotificationShown"
      summary="(obsolete) feature notification guide sign in notification"/>
  <variant name="IPH_FeatureNotificationGuideVoiceSearchHelpBubble"
      summary="(obsolete) feature notification guide voice search help bubble"/>
  <variant name="IPH_FeatureNotificationGuideVoiceSearchNotificationShown"
      summary="(obsolete) feature notification guide voice search
               notification"/>
  <variant name="IPH_FeedCardMenu" summary="feed card menu on NTP"/>
  <variant name="IPH_FeedHeaderMenu" summary="feed header menu on NTP"/>
  <variant name="IPH_FeedSwipeRefresh" summary="swipe refreshing feeds on NTP"/>
  <variant name="IPH_FollowWhileBrowsing"
      summary="IPH for following the current site"/>
  <variant name="IPH_FuseboxAttachment"
      summary="engagement with Fusebox attachments"/>
  <variant name="IPH_GenericAlwaysTriggerHelpUiFeature"
      summary="generic feature to always show help Ui whenever asked"/>
  <variant name="IPH_GestureUserEducation"
      summary="IPH for gesture user education"/>
  <variant name="IPH_GlicPromo" summary="Glic promotion"/>
  <variant name="IPH_GlicPromoAndroid" summary="Glic promotion on Android"/>
  <variant name="IPH_GlicTrustFirstOnboardingShortcutSnoozePromo"
      summary="Glic quick access shortcut snooze promo."/>
  <variant name="IPH_GlicTrustFirstOnboardingShortcutToastPromo"
      summary="Glic quick access shortcut toast promo."/>
  <variant name="IPH_GlicTryIt" summary="Glic promo with a call to action."/>
  <variant name="IPH_GlobalMediaControls" summary="the Global Media Controls"/>
  <variant name="IPH_GMCCastStartStop"
      summary="Cast start stop in the Zenith dialog"/>
  <variant name="IPH_GMCLocalMediaCasting"
      summary="Local media cast start in GMC"/>
  <variant name="IPH_GoogleOneOfferNotification"
      summary="show google one offer notification with a visit to Google
               Drive or Google Photo"/>
  <variant name="IPH_HighEfficiencyInfoMode" summary="High efficiency info"/>
  <variant name="IPH_HighEfficiencyMode"
      summary="encourages users to turn on high efficiency mode"/>
  <variant name="IPH_HistorySearch"
      summary="Prompting users to try history search powered by AI."/>
  <variant name="IPH_HomeCustomizationMenu"
      summary="Home customization menu entrypoint on the NTP"/>
  <variant name="IPH_IdentityDisc" summary="Identity Disc"/>
  <variant name="IPH_IncognitoIndicatorCloseAllWindows"
      summary="educate users that they can close all Incognito windows by
               tapping the Incognito indicator"/>
  <variant name="IPH_IncognitoWindow" summary="incognito window"/>
  <variant name="IPH_InstanceSwitcher" summary="instance switcher"/>
  <variant name="IPH_IntentChip" summary="opening a webpage in an app"/>
  <variant name="IPH_iOSAddressPromoDesktop"
      summary="showing the iOS address promo on desktop"/>
  <variant name="IPH_iOSAIHubNewBadge"
      summary="AI Hub entrypoint on the omnibox"/>
  <variant name="IPH_iOSBWGPromo" summary="shows users a promo for BWG"/>
  <variant name="IPH_iOSChoiceScreenFeature"
      summary="(obsolete) showing the Choice screen on iOS"/>
  <variant name="IPH_iOSContextualPanelPriceInsights"
      summary="contextual panel price insights IPH impression tracking"/>
  <variant name="IPH_iOSContextualPanelSampleModel"
      summary="contextual panel sample model IPH impression tracking"/>
  <variant name="IPH_iOSDefaultBrowserBadgeEligibility"
      summary="default browser badge promo eligibility tracking"/>
  <variant name="IPH_iOSDefaultBrowserBannerPromoFeature"
      summary="iOS Default browser banner promo"/>
  <variant name="IPH_iOSDefaultBrowserOffCyclePromo"
      summary="showing the Default Browser off-cycle Promo on iOS"/>
  <variant name="IPH_iOSDefaultBrowserOverflowMenuBadge"
      summary="default browser badge promo on the overflow menu"/>
  <variant name="IPH_iOSDefaultBrowserSettingsBadge"
      summary="default browser badge promo on the settings menu row"/>
  <variant name="IPH_iOSDefaultBrowserVideoPromoTrigger"
      summary="(obsolete) notifying that the conditions to show the default
               browser video promo have been met."/>
  <variant name="IPH_iOSDockingPromo"
      summary="Showing the Docking Promo on iOS"/>
  <variant name="IPH_iOSDownloadAutoDeletion"
      summary="Showing the Auto Deletion IPH on iOS."/>
  <variant name="IPH_iOSEnhancedBrowsingDesktop"
      summary="showing the iOS enhanced browsing promo on desktop"/>
  <variant name="IPH_iOSFeedSwipeAnimatedFeature"
      summary="Showing the animated Feed Swipe IPH on iOS."/>
  <variant name="IPH_iOSFeedSwipeStaticFeature"
      summary="Showing the static Feed Swipe IPH on iOS."/>
  <variant name="IPH_iOSGeminiContextualCueChip"
      summary="Gemini contextual cue chip on the omnibox"/>
  <variant name="IPH_iOSGeminiExternalAppStoreEvent"
      summary="shows Gemini IPH bubble after Gemini FRE is invoked from an
               external App Store event and dismissed"/>
  <variant name="IPH_iOSGeminiFullscreenPromoFeature"
      summary="showing the fullscreen Gemini promo on iOS"/>
  <variant name="IPH_iOSGeminiImageRemix"
      summary="showing the Gemini Image Remix IPH on iOS"/>
  <variant name="IPH_iOSHistoryOnOverflowMenuFeature"
      summary="history item on the overflow menu on iOS"/>
  <variant name="IPH_iOSHomepageCustomizationNewBadge"
      summary="showing the new badge IPH on the homepage customization menu
               button"/>
  <variant name="IPH_iOSHomepageLensNewBadge"
      summary="showing the new badge IPH on the Lens entrypoint in the
               homepage Omnibox"/>
  <variant name="IPH_iOSInlineEnhancedSafeBrowsingPromoFeature"
      summary="Showing the Enhanced Safe Browsing Promo on iOS"/>
  <variant name="IPH_iOSLensOverlayEntrypointTip"
      summary="IOS Lens overlay toolbar entrypoint"/>
  <variant name="IPH_iOSLensOverlayEscapeHatchTip"
      summary="IOS Lens overlay Escape Hatch"/>
  <variant name="IPH_iOSLensPromoDesktop"
      summary="showing the iOS lens promo on desktop"/>
  <variant name="IPH_iOSNewIAPromoFeature"
      summary="showing the IPH when the user is starting the app with the new
               IA for the first time"/>
  <variant name="IPH_iOSOneTimeDefaultBrowserNotification"
      summary="scheduling the One Time Default Browser notification on iOS"/>
  <variant name="IPH_iOSOverflowMenuCustomization"
      summary="overflow menu customization"/>
  <variant name="IPH_iOSPageActionMenu"
      summary="shows users an IPH for PageActionMenu"/>
  <variant name="IPH_iOSPageInfoRevamp"
      summary="(obsolete) showing the Page Info Revamp new badge IPH on the
               overflow menu carousel"/>
  <variant name="IPH_iOSParcelTrackingFeature"
      summary="(obsolete) showing the Parcel Tracking IPH on the Magic Stack"/>
  <variant name="IPH_iOSPasswordPromoDesktop"
      summary="showing the iOS password promo on desktop"/>
  <variant name="IPH_iOSPaymentPromoDesktop"
      summary="showing the iOS payment promo on desktop"/>
  <variant name="IPH_iOSPinMostVisitedSiteFeature"
      summary="showing the in-product help for customizing sites on the most
               visited tiles on iOS"/>
  <variant name="IPH_iOSPostDefaultAbandonmentPromo"
      summary="showing the iOS post-default browser abandonment promo on iOS"/>
  <variant name="IPH_iOSPriceTrackingDesktop"
      summary="showing the price tracking desktop to mobile promo on desktop"/>
  <variant name="IPH_iOSPromoAllTabs"
      summary="showing All Tabs default browser promo"/>
  <variant name="IPH_iOSPromoAppStore"
      summary="showing the App Store Promo on iOS"/>
  <variant name="IPH_iOSPromoBackgroundCustomization"
      summary="Background customization feature for the iOS NTP"/>
  <variant name="IPH_iOSPromoCredentialProviderExtension"
      summary="showing the Credential Provider Extension Promo on iOS"/>
  <variant name="IPH_iOSPromoDefaultBrowser"
      summary="showing the Default Browser Promo on iOS"/>
  <variant name="IPH_iOSPromoDefaultBrowserReminder"
      summary="showing the Default Browser Promo after remind me later on iOS"/>
  <variant name="IPH_iOSPromoGenericDefaultBrowser"
      summary="showing generic default browser promo"/>
  <variant name="IPH_iOSPromoMadeForIOS"
      summary="showing Made for iOS default browser promo"/>
  <variant name="IPH_iOSPromoNonModalAppSwitcherDefaultBrowser"
      summary="showing the non-modal Default Browser Promo from app switcher
               on iOS"/>
  <variant name="IPH_iOSPromoNonModalShareDefaultBrowser"
      summary="showing the non-modal Default Browser Promo from share on iOS"/>
  <variant name="IPH_iOSPromoNonModalSigninBookmark"
      summary="showing the non-modal sign-in promo for add a bookmark."/>
  <variant name="IPH_iOSPromoNonModalSigninPassword"
      summary="showing the non-modal sign-in promo for save a password."/>
  <variant name="IPH_iOSPromoNonModalUrlPasteDefaultBrowser"
      summary="showing the non-modal Default Browser Promo from omnibox paste
               on iOS"/>
  <variant name="IPH_iOSPromoOverflowMenuDestinationDefaultBrowser"
      summary="showing the Overflow Menu Destination Default Browser Promo on
               iOS"/>
  <variant name="IPH_iOSPromoOverflowMenuShortcutsDefaultBrowser"
      summary="showing the Overflow Menu Shortcuts Default Browser Promo on
               iOS"/>
  <variant name="IPH_iOSPromoPasswordManagerWidget"
      summary="showing the Password Manager widget promo on iOS"/>
  <variant name="IPH_iOSPromoPostRestore"
      summary="showing the Post Restore Promo on iOS"/>
  <variant name="IPH_iOSPromoPostRestoreDefaultBrowser"
      summary="showing the Post Restore Default Browser Promo on iOS"/>
  <variant name="IPH_iOSPromoSettingsCardDefaultBrowser"
      summary="showing the Settings Card Default Browser Promo on iOS"/>
  <variant name="IPH_iOSPromoSettingsCellDefaultBrowser"
      summary="showing the Settings Cell Default Browser Promo on iOS"/>
  <variant name="IPH_iOSPromoSigninFullscreen"
      summary="showing the Signin Fullscreen Promo on iOS"/>
  <variant name="IPH_iOSPromoStaySafe"
      summary="showing Stay Safe default browser promo"/>
  <variant name="IPH_iOSPromoWhatsNew"
      summary="showing the Whats New Promo on iOS"/>
  <variant name="IPH_iOSPullToRefreshFeature"
      summary="the full screen IPH for pull to refresh"/>
  <variant name="IPH_iOSReaderModeLargeOmniboxEntrypointFeature"
      summary="the eligibility of the expanded omnibox entrypoint for Reading
               Mode on iOS"/>
  <variant name="IPH_iOSReaderModeOptionsFeature"
      summary="the IPH for Reader Mode options"/>
  <variant name="IPH_iOSReminderNotificationsOverflowMenuBubbleFeature"
      summary="Overflow menu bubble IPH to schedule tab reminders"/>
  <variant name="IPH_iOSReminderNotificationsOverflowMenuNewBadgeFeature"
      summary="Overflow menu new badge IPH to schedule tab reminders"/>
  <variant name="IPH_iOSReplaceSyncPromosWithSignInPromos"
      summary="account row in settings page"/>
  <variant name="IPH_iOSSafariImportFeature"
      summary="Showing the Safari Import entry point on iOS"/>
  <variant name="IPH_iOSSavedTabGroupClosed"
      summary="showing the IPH when closing a saved tab group for the first
               time"/>
  <variant name="IPH_iOSSettingsInOverflowMenuBubbleFeature"
      summary="settings in the overflow menu"/>
  <variant name="IPH_iOSSharedTabGroupForeground"
      summary="showing the IPH when the user is returning to an opened shared
               tab group"/>
  <variant name="IPH_iOSSwipeBackForward"
      summary="the full screen IPH for edge swipe on page to go backward or
               forward"/>
  <variant name="IPH_iOSSwipeToolbarToChangeTab"
      summary="the full screen IPH for swipe on the toolbar to go to the
               previous or next tab in the tab list"/>
  <variant name="IPH_iOSSwitchAccountsWithNTPAccountParticleDiscFeature"
      summary="educate users about the option of switching accounts in Chrome
               via the account particle disc"/>
  <variant name="IPH_iOSTabGridSwipeRightForIncognito"
      summary="the full screen IPH for left swipe on regular tab grid to
               browse in incognito"/>
  <variant name="IPH_iOSTabGroupsDesktop"
      summary="showing the tab groups promo on desktop"/>
  <variant name="IPH_iOSWelcomeBack"
      summary="shows returning users features they may be interested in"/>
  <variant name="IPH_KeyboardAccessoryAddressFilling"
      summary="address autofill suggestions"/>
  <variant name="IPH_KeyboardAccessoryPasswordFilling"
      summary="password autofill suggestions"/>
  <variant name="IPH_KeyboardAccessoryPaymentFilling"
      summary="payments autofill suggestions"/>
  <variant name="IPH_KeyboardAccessoryPaymentOffer"
      summary="payments autofill suggestions that have an offer"/>
  <variant name="IPH_LauncherSearchHelpUi"
      summary="show launcher search chips in the launcher"/>
  <variant name="IPH_LensOverlay" summary="Lens Overlay"/>
  <variant name="IPH_LensOverlayTranslateButton"
      summary="Lens Overlay translate button"/>
  <variant name="IPH_LiveCaption" summary="(obsolete) Live Caption"/>
  <variant name="IPH_LongPressToolbarTip" summary="LongPress toolbar"/>
  <variant name="IPH_MicToolbar" summary="the mic button in the toolbar"/>
  <variant name="IPH_MostVisitedTilesCustomizationPin"
      summary="informing user of context menu to pin a shortcut on MVT"/>
  <variant name="IPH_MultistepFilterPromo"
      summary="informing user about Multistep Filter suggestions on first
               usage"/>
  <variant name="IPH_NewTab" summary="new tab"/>
  <variant name="IPH_NewTabPageHomeButton"
      summary="(obsolete) new tab page button"/>
  <variant name="IPH_NewTabPageThemeCustomization"
      summary="informing user of customizing new tab page theme via NTP
               customization option in the App menu"/>
  <variant name="IPH_NewTabTip" summary="new tab tip"/>
  <variant name="IPH_PageInfo" summary="opening PageInfo"/>
  <variant name="IPH_PageInfoStoreInfo" summary="PageInfoStoreInfo feature"/>
  <variant name="IPH_PageSummaryPdfMenu" summary="the analyze pdf menu item"/>
  <variant name="IPH_PageSummaryWebMenu"
      summary="the web page summary menu item"/>
  <variant name="IPH_PageZoom"
      summary="educating users about the zoom option in the main menu"/>
  <variant name="IPH_PasswordManagerShortcut"
      summary="Password Manager shortcut."/>
  <variant name="IPH_PasswordSharingFeature"
      summary="educating the users about password sharing when they open
               password details page"/>
  <variant name="IPH_PasswordsManagementBubbleAfterSave"
      summary="educating the users about the password management bubble after
               saving a password"/>
  <variant name="IPH_PasswordsManagementBubbleDuringSignin"
      summary="educating the users about the password management bubble
               during signin flows"/>
  <variant name="IPH_PasswordsSavePrimingPromo"
      summary="prompting users to consider saving passwords in the browser"/>
  <variant name="IPH_PasswordsSaveRecoveryPromo"
      summary="prompting users to reconsider saving passwords in the browser"/>
  <variant name="IPH_PasswordSuggestions"
      summary="the Autofill password suggestions on iOS"/>
  <variant name="IPH_PasswordsWebAppProfileSwitch"
      summary="profile switch in Password Manager web app"/>
  <variant name="IPH_PdfGlicSummarizeFeature"
      summary="educating users about PDF Glic Summarize feature"/>
  <variant name="IPH_PdfInkSignatures"
      summary="educating users about PDF Ink Signatures feature"/>
  <variant name="IPH_PdfPageDownload"
      summary="educating users about the pdf download option in the app menu"/>
  <variant name="IPH_PdfSearchifyFeature"
      summary="educating users about PDF searchify feature"/>
  <variant name="IPH_PdfTextAnnotations"
      summary="educating users about PDF Text Annotations feature"/>
  <variant name="IPH_PdfTranslateBubble"
      summary="educating users about PDF translate bubble feature"/>
  <variant name="IPH_PerformanceInterventionDialog"
      summary="triggering the performance intervention dialog and toolbar
               button"/>
  <variant name="IPH_PerformanceNewBadge"
      summary="New badge shows next to performance item on the app menu"/>
  <variant name="IPH_PlusAddressCreateSuggestion"
      summary="(obsolete) message shown in Autofill dropdown to educate users
               on the existence of the plus address benefits"/>
  <variant name="IPH_PlusAddressFirstSaveFeature"
      summary="(obsolete) custom action shown after creation of first plus
               address that informs user about management UI for plus address"/>
  <variant name="IPH_PowerBookmarksSidePanel"
      summary="prompting users to view bookmarks in the side panel"/>
  <variant name="IPH_PreviewsOmniboxUI"
      summary="the Previews UI in the Android Omnibox"/>
  <variant name="IPH_PriceDropNTP"
      summary="the in product help message to inform users that a price drop
               has occurred in a tab"/>
  <variant name="IPH_PriceInsightsPageActionIconLabel"
      summary="price insights page action icon label triggering"/>
  <variant name="IPH_PriceTrackingChipFeature"
      summary="first time user sees the price tracking page action icon"/>
  <variant name="IPH_PriceTrackingEmailConsentFeature"
      summary="An email consent dialog shown after saving a product if a
               decision about receiving email notifications has not been
               made."/>
  <variant name="IPH_PriceTrackingInSidePanel"
      summary="first time user tracks a product to educate them to see the
               price tracking list in side panel"/>
  <variant name="IPH_PriceTrackingPageActionIconLabel"
      summary="price tracking page action icon label triggering"/>
  <variant name="IPH_ProfileSwitch"
      summary="switching profiles using the profile menu"/>
  <variant name="IPH_PwaInstallAvailableFeature"
      summary="surfacing the Android PWA install option"/>
  <variant name="IPH_PwaQuietNotification"
      summary="the PWA quiet notification feature"/>
  <variant name="IPH_ReadAloudAppMenuFeature"
      summary="the Read Aloud button in the overflow menu"/>
  <variant name="IPH_ReadAloudExpandedPlayerFeature"
      summary="promotes expanded player for Read Aloud"/>
  <variant name="IPH_ReadAloudPlaybackModeFeature"
      summary="promotes playback mode selector for Read Aloud"/>
  <variant name="IPH_ReaderModeDistillInApp"
      summary="educating users about the reader mode distill in app feature
               on Android"/>
  <variant name="IPH_ReadingListDiscovery"
      summary="first time a tab is added to reading list"/>
  <variant name="IPH_ReadingListEntryPoint"
      summary="educating users to click the star icon to add a tab to reading
               list"/>
  <variant name="IPH_ReadingListInSidePanel"
      summary="promotes use of the reading list in the side panel"/>
  <variant name="IPH_ReadingListMessages"
      summary="the Reading List entry point in iOS tools menu"/>
  <variant name="IPH_ReadingMode"
      summary="educating users to click the side panel icon to open reading
               mode"/>
  <variant name="IPH_ReadingModeKeyboardShortcut"
      summary="promotes the keyboard shortcut for reading mode"/>
  <variant name="IPH_ReadingModePageActionLabel"
      summary="promotes the new omnibox entrypoint for reading mode"/>
  <variant name="IPH_ReadingModePresentationMode"
      summary="promotes the view switching feature in Reading Mode"/>
  <variant name="IPH_ReadingModeSidePanel"
      summary="promotes use of reading mode in the side panel"/>
  <variant name="IPH_ReadLaterAppMenuBookmarks" summary="read later app menu"/>
  <variant name="IPH_ReadLaterAppMenuBookmarkThisPage"
      summary="read later app menu"/>
  <variant name="IPH_ReadLaterBottomSheet"
      summary="read later bottom sheet entry point"/>
  <variant name="IPH_ReadLaterContextMenu"
      summary="read later context menu entry point"/>
  <variant name="IPH_RecentTabs"
      summary="prompting the user that they can find their recently closed
               tabs and windows in the 'Recent tabs' surface"/>
  <variant name="IPH_ReopenTab" summary="reopening closed tabs"/>
  <variant name="IPH_RequestDesktopSiteAppMenu"
      summary="(obsolete) educating users about using the desktop site app
               menu item to add a site-level exception"/>
  <variant name="IPH_RequestDesktopSiteDefaultOn"
      summary="the in product help message to let users opt out of desktop
               site global settings default-on"/>
  <variant name="IPH_RequestDesktopSiteExceptionsGeneric"
      summary="educating tablet users about using the desktop site per-site
               settings in general"/>
  <variant name="IPH_RequestDesktopSiteOptIn"
      summary="(obsolete) the in product help message to let users turn on
               the desktop site global settings"/>
  <variant name="IPH_RequestDesktopSiteWindowSetting"
      summary="educating users about using the desktop site window setting"/>
  <variant name="IPH_RestoreTabsOnFRE"
      summary="the in product help sheet to let users know they can restore
               tabs from other synced devices on a fresh Chrome install"/>
  <variant name="IPH_ResumptionRail"
      summary="educating users about the Resumption Rail feature entrypoint"/>
  <variant name="IPH_RtlGestureNavigation"
      summary="the in product help dialog to educate users on how to do
               gesture navigation in RTL mode."/>
  <variant name="IPH_SearchPromotionFeature"
      summary="Showing the Search extension promo on Windows"/>
  <variant name="IPH_SendTabToSelfOmnibox"
      summary="IPH for Send Tab to Self entry point in the omnibox long-press
               menu"/>
  <variant name="IPH_SharedHighlightingBuilder"
      summary="the in product help message to notify the user that the share
               action can preemptively share a link-to-text"/>
  <variant name="IPH_SharedHighlightingReceiver"
      summary="the in product help message encouraging users to create
               highlights"/>
  <variant name="IPH_SharingHubLinkToggle"
      summary="turning on link sharing in the Sharing Hub"/>
  <variant name="IPH_ShoppingCollectionFeature"
      summary="UI that is shown in the bookmark save flow when a page is
               saved to the shopping collection"/>
  <variant name="IPH_ShoppingListMenuItem"
      summary="A text bubble showing that a product can be tracked from the
               overflow menu"/>
  <variant name="IPH_SideBySidePinnableFeature"
      summary="side by side split view tabs pinnable IPH"/>
  <variant name="IPH_SideBySideTabSwitchFeature"
      summary="side by side split view tab switch IPH"/>
  <variant name="IPH_SidePanelContextualTasksPinnableFeature"
      summary="contextual tasks side panel pinnable"/>
  <variant name="IPH_SidePanelGenericPinnableFeature"
      summary="side panel pinnable"/>
  <variant name="IPH_SidePanelLensOverlayPinnableFeature"
      summary="lens overlay side panel pinnable"/>
  <variant name="IPH_SidePanelLensOverlayPinnableFollowupFeature"
      summary="lens overlay side panel pinnable follow-up"/>
  <variant name="IPH_SideSearch" summary="side search discovery"/>
  <variant name="IPH_SideSearchAutoTriggering"
      summary="side search automatic triggering"/>
  <variant name="IPH_SideSearchPageActionLabel"
      summary="side search page action label triggering"/>
  <variant name="IPH_SignInBenefits"
      summary="IPH informing signed-in users of benefits after the
               sync-to-signin migration."/>
  <variant name="IPH_SignInBenefitsNewSignin"
      summary="IPH informing signed-in users of benefits after the
               sync-to-signin migration."/>
  <variant name="IPH_SiteControls"
      summary="educating users that site controls have moved to the app menu"/>
  <variant name="IPH_SmartTabSharingDefaultOnFeature"
      summary="Smart Tab Sharing Default On custom UI feature"/>
  <variant name="IPH_SmartTabSharingFeature"
      summary="Smart Tab Sharing feature"/>
  <variant name="IPH_SmartTabSharingTryItFeature"
      summary="Smart Tab Sharing Try It custom UI feature"/>
  <variant name="IPH_SplitViewHorizontalIndirectAccessFeature"
      summary="Top/bottom splits indirect access IPH"/>
  <variant name="IPH_SupervisedUserProfileSignin"
      summary="informing supervised users about parental controls"/>
  <variant name="IPH_TabAudioMuting" summary="muting tab audio"/>
  <variant name="IPH_TabGroupsDragAndDrop"
      summary="educating user to drop one tab on another tab to create group"/>
  <variant name="IPH_TabGroupSharedNotificationBubbleOnStrip"
      summary="For tab group share notification bubble on tablet tab strip."/>
  <variant name="IPH_TabGroupsQuicklyComparePages"
      summary="(obsolete) long pressing a link to open in a tab group"/>
  <variant name="IPH_TabGroupsRemoteGroup"
      summary="IPH highlighting a synced tab group"/>
  <variant name="IPH_TabGroupsSaveV2CloseGroup"
      summary="IPH for tab group closing adding them to a new location"/>
  <variant name="IPH_TabGroupsSaveV2Intro"
      summary="IPH for tab groups defaulting to saved"/>
  <variant name="IPH_TabGroupsSharedTabChanged"
      summary="IPH for the first time a shared tab is changed"/>
  <variant name="IPH_TabGroupsSharedTabFeedback"
      summary="IPH for the first time a shared tab becomes the active tab"/>
  <variant name="IPH_TabGroupsSurface" summary="IPH for tab groups surface"/>
  <variant name="IPH_TabGroupsSurfaceOnHide"
      summary="IPH for tab groups surface after hiding a tab group while on
               the GTS"/>
  <variant name="IPH_TabGroupsTapToSeeAnotherTab"
      summary="(obsolete) tab strip"/>
  <variant name="IPH_TabGroupSyncOnStrip"
      summary="For tab group sync on tablet tab strip."/>
  <variant name="IPH_TabGroupsYourTabsTogether"
      summary="tab switcher cards with multiple tab thumbnails"/>
  <variant name="IPH_TabOrganizationSuccess"
      summary="(obsolete) tab organization success"/>
  <variant name="IPH_TabScrollButtonFeature"
      summary="IPH for tab horizontal scroll buttons"/>
  <variant name="IPH_TabSearch" summary="tab search discovery"/>
  <variant name="IPH_TabSearchComboButton"
      summary="IPH for the first time a user opens Chrome with tab search
               moved to the tab strip combo button"/>
  <variant name="IPH_TabSearchToolbarButton"
      summary="IPH for the first time a user opens Chrome with tab search
               moved to a toolbar button"/>
  <variant name="IPH_TabSwitcherButton" summary="tab switcher button"/>
  <variant name="IPH_TabSwitcherButtonSwitchIncognito"
      summary="Switch to incognito via tab switcher button"/>
  <variant name="IPH_TabSwitcherFloatingActionButton"
      summary="tab switcher floating action button"/>
  <variant name="IPH_ThreeDotMenuBackButton"
      summary="tab switcher floating action button"/>
  <variant name="IPH_ToolbarManagementButton"
      summary="toolbar management button"/>
  <variant name="IPH_TouchToSearchCallout"
      summary="Touch to search IPH feature"/>
  <variant name="IPH_TrackingProtectionOffboarding"
      summary="(obsolete) tracking protection offboarding notice"/>
  <variant name="IPH_TrackingProtectionOnboarding"
      summary="(obsolete) tracking protection onboarding notice"/>
  <variant name="IPH_TranslateMenuButton" summary="translate menu button"/>
  <variant name="IPH_UpdatedConnectionSecurityIndicators"
      summary="updated omnibox connection security indicators"/>
  <variant name="IPH_VerticalTabsExpandOnHoverFeature"
      summary="The vertical tabstrip expand on hover IPH"/>
  <variant name="IPH_VerticalTabstripTutorialFeature"
      summary="The vertical tabstrip IPH"/>
  <variant name="IPH_VideoTutorial_NTP_ChromeIntro"
      summary="Video tutorial card on NTP about introduction to chrome"/>
  <variant name="IPH_VideoTutorial_NTP_Download"
      summary="Video tutorial card on NTP about downloading in chrome"/>
  <variant name="IPH_VideoTutorial_NTP_Search"
      summary="Video tutorial card on NTP about search in chrome"/>
  <variant name="IPH_VideoTutorial_NTP_Summary"
      summary="Video tutorial summary card on NTP"/>
  <variant name="IPH_VideoTutorial_NTP_VoiceSearch"
      summary="Video tutorial card on NTP about voice search in chrome"/>
  <variant name="IPH_VideoTutorial_TryNow"
      summary="Video tutorial Try Now feature"/>
  <variant name="IPH_WebUiHelpBubbleTest"
      summary="testing the WebUI help bubble"/>
  <variant name="IPH_WhatsNewUpdated"
      summary="educating user that what's new has new content"/>
</variants>

<histogram name="InProductHelp.Config.ParsingEvent" enum="ConfigParsingEvent"
    expires_after="2026-08-09">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if in-product help configuration is parsed correctly, and the
    failure reasons for parsing failures.
  </summary>
</histogram>

<histogram name="InProductHelp.Db.Init.{IPHDatabase}" enum="BooleanSuccess"
    expires_after="2025-01-05">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if {IPHDatabase} database initialization succeeds for in-product
    help.
  </summary>
  <token key="IPHDatabase" variants="IPHDatabase"/>
</histogram>

<histogram name="InProductHelp.Db.Load.{IPHDatabase}" enum="BooleanSuccess"
    expires_after="2024-12-22">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if {IPHDatabase} database successfully loads the data for in-product
    help.
  </summary>
  <token key="IPHDatabase" variants="IPHDatabase"/>
</histogram>

<histogram name="InProductHelp.Db.TotalEvents" units="events"
    expires_after="2027-02-07">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records the total number of event records in the database for in-product
    help after the event model is loaded.
  </summary>
</histogram>

<histogram name="InProductHelp.Db.Update.{IPHDatabase}" enum="BooleanSuccess"
    expires_after="2025-01-05">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if {IPHDatabase} database update succeeds for in-product help.
  </summary>
  <token key="IPHDatabase" variants="IPHDatabase"/>
</histogram>

<histogram name="InProductHelp.DismissalReason.iOS"
    enum="InProductHelpDismissalReason" expires_after="2026-12-27">
  <owner>lpromero@google.com</owner>
  <owner>gambard@chromium.org</owner>
  <summary>
    Records how the in-product help bubble was dismissed on iOS.
  </summary>
</histogram>

<histogram name="InProductHelp.EventStorageMigration.Status"
    enum="InProductHelpEventStorageMigrationStatus" expires_after="2026-10-11">
  <owner>cheickcisse@google.com</owner>
  <owner>shaktisahu@chromium.org</owner>
  <summary>
    Records the status of the migration of events from profile storage to event
    storage. This is recorded once per profile on startup. It is not recorded if
    the OnDeviceStorage feature flag is not enabled, and this feature is only
    enabled for iOS.
  </summary>
</histogram>

<histogram name="InProductHelp.Gestural.DismissalReason.iOS"
    enum="InProductHelpDismissalReason" expires_after="2026-11-01">
  <owner>ginnyhuang@chromium.org</owner>
  <owner>adamta@google.com</owner>
  <summary>
    Recorded when a gestural in-product help view is dismissed, with the enum
    signifying the way the dismissal was triggered.
  </summary>
</histogram>

<histogram name="InProductHelp.InitializationTime.Total" units="ms"
    expires_after="2027-02-07">
  <owner>agazal@chromium.org</owner>
  <owner>mschillaci@chromium.org</owner>
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records the total end-to-end time taken for the Feature Engagement Tracker
    to become fully initialized at startup. This includes asynchronous database
    loading, event processing, profile-to-device migration (on iOS), and event
    exports.
  </summary>
</histogram>

<histogram name="InProductHelp.NotifyEventReadyState.{IPHFeature}"
    enum="BooleanSuccess" expires_after="2027-02-07">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if the model is ready when in-product help event happens for
    {IPHFeature}.
  </summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="InProductHelp.ShouldTriggerHelpUI.{IPHFeature}"
    enum="TriggerHelpUIResult" expires_after="2027-02-07">
  <owner>nyquist@chromium.org</owner>
  <summary>
    Records if in-product help for {IPHFeature} is shown to the user, and the
    failure reasons if in-product help is not shown. Recorded on its own across
    all in-product help features, in addition to being a base name for
    feature-specific histograms.
  </summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="InProductHelp.ShownTime.{IPHFeature}" units="ms"
    expires_after="2027-02-07">
  <owner>lpromero@google.com</owner>
  <owner>gambard@chromium.org</owner>
  <summary>
    Records the time duration during which the in-product help for {IPHFeature}
    is shown. The timer automatically starts when the feature engagement system
    says a particular IPH should be displayed. The timer is stopped and recorded
    when the IPH is dismissed.
  </summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="InProductHelp.ShownTime2.{IPHFeature}" units="ms"
    expires_after="2027-02-07">
  <owner>gayane@google.com</owner>
  <owner>lpromero@google.com</owner>
  <owner>gambard@chromium.org</owner>
  <summary>
    Same as InProductHelp.ShownTime.{IPHFeature} but records times up to 3
    minutes. InProductHelp.ShownTime.{IPHFeature} can be deprecated after some
    time to ensure continuity of information.
  </summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="InProductHelp.SnoozeAction" enum="InProductHelpSnoozeAction"
    expires_after="2025-02-10">
  <owner>haileywang@chromium.org</owner>
  <owner>shaktisahu@chromium.org</owner>
  <summary>
    Records the action taken by the user on a snoozable in-product help bubble.
  </summary>
</histogram>

<histogram name="InProductHelp.TextBubble.ShownTime" units="ms"
    expires_after="2025-05-11">
  <owner>haileywang@chromium.org</owner>
  <owner>shaktisahu@chromium.org</owner>
  <summary>
    The time duration for which the in-product help bubble is shown.
  </summary>
</histogram>

<histogram name="InProductHelp.TextBubble.ShowSnooze" enum="BooleanShown"
    expires_after="2023-02-12">
  <owner>haileywang@chromium.org</owner>
  <owner>shaktisahu@chromium.org</owner>
  <summary>
    Records if the snooze button was shown on an in-product help bubble.
  </summary>
</histogram>

<!--

IMPORTANT NOTE:

All UserEducation.* histograms should go in:
  //tools/metrics/histograms/metadata/user_education/histograms.xml

The following are only here because they rely on the `IPHFeature` variants.
In the future, Desktop IPH may be completely moved to the user_education folder.

-->

<!-- expires-never: this is a meta-histogram that provides performance
     information about each feature promo as it rolls out to users. Since new
     promos roll out all the time, and feature teams want to track the
     performance of their promos, this histogram must never expire. -->

<histogram name="UserEducation.MessageAction.{IPHFeature}" enum="MessageAction"
    expires_after="never">
  <owner>mickeyburks@chromium.org</owner>
  <owner>frizzle-team@google.com</owner>
  <summary>Records what action was taken to close the In-Product Help.</summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="UserEducation.MessageNotShown.TimeInQueue.{IPHFeature}"
    units="ms" expires_after="2027-01-03">
  <owner>dfried@chromium.org</owner>
  <owner>frizzle-team@google.com</owner>
  <summary>
    Records the amount of time a specific IPH promo spends in queue before not
    being shown. Is not recorded for promos that are immediately rejected due to
    failed requirements, promos which are explicitly canceled, or promos which
    are actually shown (see UserEducation.MessageShown.TimeInQueue.*).
  </summary>
</histogram>

<!-- expires-never: this is a meta-histogram that provides performance
     information about each feature promo as it rolls out to users. Since new
     promos roll out all the time, and feature teams want to track the
     performance of their promos, this histogram must never expire. -->

<histogram name="UserEducation.MessageNotShown.{IPHFeature}"
    enum="PromoFailure" expires_after="never">
  <owner>mickeyburks@chromium.org</owner>
  <owner>frizzle-team@google.com</owner>
  <summary>
    Records what failure prevented a particular In-Product Help from being shown
    to the user. The failure defines the state of the User Education system,
    which can be many varieties (e.g. snoozed, disabled blocked by another
    promo, etc.).
  </summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

<histogram name="UserEducation.MessageShown.TimeInQueue.{IPHFeature}"
    units="ms" expires_after="2027-02-07">
  <owner>dfried@chromium.org</owner>
  <owner>frizzle-team@google.com</owner>
  <summary>
    Records the amount of time a specific IPH promo spends in queue before being
    shown. Is not recorded if the promo is not shown (see
    UserEducation.MessageNotShown.TimeInQueue.*).
  </summary>
</histogram>

<!-- expires-never: this is a meta-histogram that provides performance
     information about rotating feature promos as they roll out to users. Since
     new promos roll out all the time, and feature teams want to track the
     performance of their promos, this histogram must never expire. -->

<histogram name="UserEducation.RotatingPromoIndex.{IPHFeature}" units="Index"
    expires_after="never">
  <owner>dfried@chromium.org</owner>
  <owner>frizzle-team@google.com</owner>
  <summary>
    Record the index of a rotating promo when it is shown to the user. This can
    be used to determine how deep in the rotation of rotating promos users are
    going, and also what proportion of users have seen a particular promo from a
    rotating promo set.
  </summary>
  <token key="IPHFeature" variants="IPHFeature"/>
</histogram>

</histograms>

</histogram-configuration>
