You set up a custom event in GTM, fire it, confirm it in DebugView — but the event parameter never appears in GA4 reports. This is one of the most common GA4 configuration gaps: event parameters don’t automatically become reportable dimensions. You must register them as Custom Dimensions. Here’s exactly how to do it and what goes wrong.

Why Parameters Don’t Appear in Reports

GA4 has two layers: raw event storage (everything you send is stored in BigQuery) and reporting dimensions (only registered parameters appear in the UI). When you send form_id: ‘contact’, GA4 stores it in BigQuery but won’t show it in reports until you register it as a custom dimension.

How to Register a Custom Dimension

Go to GA4 Admin → Data Display → Custom Definitions → Create Custom Dimension. Set:

  • Dimension name: Human-readable label (e.g., “Form ID”)
  • Scope: Event (tied to a specific event) or User (persists across sessions)
  • Event parameter: Exact parameter name as sent (e.g., form_id — case-sensitive)

Custom dimensions only populate going forward from the date you create them. Historical data won’t backfill in the GA4 UI — but the data IS in BigQuery if you need historical values.

Custom Dimension Limits

Standard GA4 properties have a 50 custom dimension limit (event-scoped) and 25 user-scoped limit. GA4 360 gets 125 event-scoped. If you hit the limit, archive unused dimensions before creating new ones. Archived dimensions retain historical data but don’t accept new values.

GA4 Event Parameters Not Showing in Reports: Custom Dimensions Fix

The 24-Hour Delay

After registering, custom dimensions take up to 24 hours in standard reports. DebugView shows parameters immediately. Explorations within a few hours. If still missing after 24 hours, check: parameter name typo (case-sensitive), events not firing, scope mismatch, or parameter value is empty/null.

Debug in BigQuery While Waiting

-- Verify parameter is arriving in raw data
SELECT
  event_name,
  (SELECT value.string_value FROM UNNEST(event_params) WHERE key = 'form_id') AS form_id,
  COUNT(*) as occurrences
FROM `project.analytics_XXXXXXXXX.events_today`
WHERE event_name = 'form_submit'
GROUP BY 1, 2
ORDER BY 3 DESC;

Checklist

  • ☐ Confirm parameter fires in DebugView with correct name and value
  • ☐ Register custom dimension in Admin → Custom Definitions
  • ☐ Verify exact parameter name matches (case-sensitive)
  • ☐ Choose correct scope (event vs user)
  • ☐ Wait 24 hours for standard reports; check Explorations sooner
  • ☐ Use BigQuery to validate data receipt if urgent

Related: GA4 DebugView Not Showing Events, GTM Custom HTML Tag Debugging.

Guide

Leave a Comment