[GA4] Event naming rules

When choosing a name for a new event, follow these rules:

  • Event names are case sensitive. For example, my_event and My_Event are distinct events.
  • Event names can include English and non-English words and letters.
  • Do not use reserved prefixes and event names.
  • Event names must start with a letter. Use only letters, numbers, and underscores. Don't use spaces.

Reserved prefixes and event names

The following list is not exhaustive and may be updated periodically. If you try to use a reserved prefix or name, Analytics will display an error message.

Web

Reserved event names

The following event names are reserved and cannot be used:

Note: When you create or modify events in Google Analytics, you can use any automatically collected event names mentioned in the list below.
  • app_remove
  • app_store_refund
  • app_store_subscription_cancel
  • app_store_subscription_renew
  • click
  • error
  • file_download
  • first_open
  • first_visit
  • form_start
  • form_submit
  • in_app_purchase
  • page_view
  • scroll
  • session_start
  • user_engagement
  • view_complete
  • video_progress
  • video_start
  • view_search_results

Reserved parameter names

The following parameter names are reserved and cannot be used:

  • engagement_time_msec
  • gclid
  • session_id
  • session_number

Additionally, parameter names cannot begin with:

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

Reserved user property names

The following user property names are reserved and cannot be used:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

Additionally, user property names cannot begin with:

  • _ (underscore)
  • firebase_
  • ga_
  • google_

Mobile (Android and iOS)

Reserved event names

The following event names are reserved and cannot be used:

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_impression
  • ad_query
  • ad_reward
  • adunit_exposure
  • app_clear_data
  • app_exception
  • app_install
  • app_remove
  • app_store_refund
  • app_update
  • app_upgrade
  • dynamic_link_app_open
  • dynamic_link_app_update
  • dynamic_link_first_open
  • error
  • firebase_campaign
  • firebase_in_app_message_action
  • firebase_in_app_message_dismiss
  • firebase_in_app_message_impression
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • notification_send
  • os_update
  • screen_view
  • session_start
  • user_engagement

Reserved parameter names

The following parameter names are reserved and cannot be used:

  • firebase_conversion

Additionally, parameter names cannot begin with:

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

Reserved user property names

The following user property names are reserved and cannot be used:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

Additionally, user property names cannot begin with:

  • _ (underscore)
  • firebase_
  • ga_
  • google_

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu