About the GA4 Event Builder & Naming Checker
GA4 is strict about event names, and mistakes are hard to undo once data is collected. This GA4 event builder lets you plan each custom event and its parameters, then checks names against GA4 rules: no more than 40 characters, starting with a letter, using only letters, numbers and underscores, and avoiding reserved names and the google_, ga_ and firebase_ prefixes. It also warns when an event has more than 25 parameters and encourages consistent snake_case.
When the plan is ready, the tool generates gtag.js snippets or dataLayer pushes for Google Tag Manager, and exports a tracking plan CSV for developers and analysts. Check whether a recommended event, such as generate_lead, fits before inventing a custom one. Everything runs in your browser.
How to use it
- Add an event name and describe when it should fire.
- Add parameters and fix any naming warnings.
- Copy the gtag.js or dataLayer code for your developer or GTM.
- Export the tracking plan CSV and keep it updated.
Frequently asked questions
What are the GA4 event naming rules?
Event names can be up to 40 characters, must start with a letter, and may use only letters, numbers and underscores. Names are case-sensitive. Some names are reserved, and the prefixes google_, ga_ and firebase_ cannot be used. The builder checks these rules as you type.
How many parameters can a GA4 event have?
Up to 25 parameters per event. To see custom parameters in standard reports you also need to register them as custom dimensions or metrics, which have their own property limits. Plan parameters carefully so you register only the ones you will actually analyse, and reuse the same parameter names across events.
Should I use recommended events or custom events?
Use Google's recommended events, such as login, sign_up, purchase or generate_lead, when they fit, because some reports and features expect them. Create custom events only for actions they do not cover. Following Google's documented names and parameters also makes your setup easier for other analysts to understand.