Free GA4 Event Naming Generator
Create GA4 event names that follow Google’s rules – letters, numbers and underscores, starting with a letter, 40 characters maximum – and get ready-to-paste gtag.js and dataLayer code.
GA4 event naming rules
Google Analytics 4 is strict about event names. According to Google’s documentation:
- Names may contain letters, numbers and underscores only – no spaces or hyphens.
- Names must start with a letter.
- Names are case-sensitive:
sign_upandSign_Upare separate events. - Event names can be up to 40 characters; parameter names up to 40 characters; most parameter values up to 100 characters.
- Some names are reserved for automatically collected events – for example
page_view,session_start,first_visit,click,scroll,file_download,form_startandform_submit– and some prefixes are reserved too.
Breaking these rules leads to events that are rejected, renamed or split across several rows. The generator checks all of them as you work.
How to use the generator
- Describe the interaction as action + object, e.g. “download” + “pricing pdf”. Add context only when you really need to distinguish events.
- Or paste an existing name to validate it.
- List the parameters you plan to send.
- Click Generate event name. You get a snake_case name, a validation list, recommended-event suggestions and code snippets for gtag.js and Google Tag Manager.
Input: Download · Pricing PDF · parameters file_name, file_extension, link_url
Output: download_pricing_pdf – valid, 20/40 characters.
Prefer recommended events
Before inventing a custom name, check whether Google already defines one. Recommended events – such as generate_lead, sign_up, login, search, share, add_to_cart, begin_checkout and purchase – come with documented parameters and unlock standard reports and integrations. The generator suggests one when your description contains words like “sign up”, “contact”, “quote”, “checkout” or “purchase”.
A useful rule: name the outcome rather than the UI element. generate_lead stays meaningful when the button changes colour or moves; blue_button_click does not.
Designing a clean event taxonomy
- Few events, rich parameters. Instead of
download_pdf_pricing,download_pdf_brochureand so on, use one event (file_downloadis collected automatically with enhanced measurement) and distinguish files with thefile_nameparameter. - Consistent verbs. Choose view, click, submit, start, complete, download – and keep them.
- Lowercase snake_case everywhere, including parameters.
- Register custom parameters as custom dimensions in GA4 Admin if you want to use them in standard reports.
- Document every event in a tracking plan – the GA4 tracking plan generator gives you a ready template.
About the code snippets
The gtag.js snippet works on sites that load the Google tag directly. The dataLayer snippet is for Google Tag Manager: push it when the interaction happens, then create a Custom Event trigger with the same event name and a GA4 Event tag. Replace the … placeholders with real values. Never send personal information such as email addresses or phone numbers as parameter values.
Limitations
Google notes its reserved lists are not exhaustive and may change. The generator checks the published lists and common prefixes, but GA4 Admin remains the final authority. It does not implement tracking on your site; it helps you name and document it.
Frequently asked questions
How long can a GA4 event name be?
Up to 40 characters. Parameter names are also limited to 40 characters.
Can GA4 event names contain spaces or hyphens?
No. Use letters, numbers and underscores, and start with a letter.
Are GA4 event names case-sensitive?
Yes. Use lowercase snake_case to avoid duplicates.
How many parameters can one event have?
GA4 accepts up to 25 parameters per event.
Should I use form_submit as a custom event?
No. form_submit is collected automatically by enhanced measurement and is reserved. Use generate_lead for successful lead form submissions.
Sources and further reading
- Google Analytics Help – Event naming rules
- Google Analytics Help – [GA4] Event collection limits
- Google Analytics Help – [GA4] Recommended events
- Google Analytics Help – Enhanced measurement events
- Google Tag Platform – The data layer
Formulas and rules on this page were checked against the sources above. Last reviewed: October 2026 by the AM Digital Marketing Agency team.
Related free tools
Need help with tracking and analytics?
We can set up GA4, Google Tag Manager, UTM governance and reporting for your business.