Action names

This document explains action names that are used to describe user-initiated events when integrating reCAPTCHA Enterprise on websites.

You specify action names in the action parameter of grecaptcha.enterprise.execute() when integrating reCAPTCHA Enterprise. We recommend using action names that are unique, meaningful, and not specific to users. Action names are not case-sensitive and they can only contain alphanumeric characters, slashes, and underscores. If you have a page with multiple applicable actions, you can concatenate multiple action strings together, for example, cart_view_payment.

Action names help you gain better visibility into how your users are using your site through the reCAPTCHA Metrics page. When querying for action names in the reCAPTCHA Metrics page, you must use action names in lowercase.

The following table lists some recommended action names and examples of corresponding events. Using the recommended action names also allows reCAPTCHA Enterprise to associate user actions to page types, and improves the ability to monitor for different forms of attacks, such as attackers attempting to falsify or duplicate actions.

Action name User initiated event
signup Sign up on the website.
login Log in to the website.
password_reset Request to reset the password.
get_price Fetch price for an item.
cart_add Add items to the cart.
cart_view View the contents of the cart.
payment_add Add or update payment information (e.g. card details or address).
checkout Check out from the website.
transaction_confirmed Confirmation that a transaction was processed.
play_song Play a song from a list.

What's next