Stay organized with collections
Save and categorize content based on your preferences.
This document explains action names that are used to describe user-initiated
events when integrating reCAPTCHA on websites.
You specify action names in the action parameter of grecaptcha.enterprise.execute()
when integrating reCAPTCHA. 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 reCAPTCHA dashboards in the Google Cloud console.
The following table lists some recommended action names and examples of
corresponding events. Using the recommended action names also allows
reCAPTCHA 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
To learn about how action names are used for websites, see the following:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Action names\n\nThis document explains action names that are used to describe user-initiated\nevents when integrating reCAPTCHA on websites.\n\nYou specify action names in the `action` parameter of `grecaptcha.enterprise.execute()`\nwhen integrating reCAPTCHA. We recommend using action names that\nare unique, meaningful, and not specific to users. Action names are not\ncase-sensitive and they can only contain alphanumeric characters, slashes, and\nunderscores. If you have a page with multiple applicable actions, you can\nconcatenate multiple action strings together, for example, `cart_view_payment`.\n\nAction names help you gain better visibility into how your users are using your\nsite through reCAPTCHA dashboards in the Google Cloud console.\n\nThe following table lists some recommended action names and examples of\ncorresponding events. Using the recommended action names also allows\nreCAPTCHA to associate user actions to page types, and improves the\nability to monitor for different forms of attacks, such as attackers attempting to\nfalsify or duplicate actions.\n| **Note:** Action names don't need to be confined to the following list, but we recommend applying these action names when appropriate.\n\nWhat's next\n-----------\n\n- To learn about how action names are used for websites, see the following:\n - [Install score-based keys on websites](/recaptcha/docs/instrument-web-pages)\n - [Install checkbox keys (checkbox challenge) on websites](/recaptcha/docs/instrument-web-pages-with-checkbox)"]]
