# GA4 Custom Dimensions and Testing Events in DebugView

> Register event parameters as GA4 custom dimensions, respect the 50-dimension limit, and test new events safely in DebugView.

Source: https://mentionx.ai/learn/ga4/ga4-custom-dimensions-debugview  
Author: Dipuck Jones, founder of MentionX  
Updated: 4 November 2026  
Level: Practitioner

**GA4 only shows event parameters in reports after you register them as custom dimensions or metrics, and the safest way to check new tracking is DebugView with Tag Assistant or Tag Manager preview.** Register first, test second, publish third.

> **Key takeaways**
>
> - Register parameters in Admin → Data display → Custom definitions.
> - Standard limits: 50 event-scoped custom dimensions and 50 custom metrics (125 each on 360).
> - Registration is not retroactive. Data before registration won't appear in that dimension.
> - DebugView shows events from devices in debug mode, in near real time.
> - Don't send personal data such as emails in parameters.

*Checked 4 November 2026 (CET) against Google Analytics Help and Google developer documentation. GA4 menus and limits change, so confirm in your own property. "Our view" marks MentionX opinion. Ledgerline is a fictional company used for illustration.*

## Dimensions marketers usually register

| Parameter | Scope | Why |
|---|---|---|
| form_id | Event | Separate demo, contact and newsletter forms |
| cta_id | Event | Which button drove the click |
| content_group or page_type | Event | Blog vs product vs comparison page |
| plan_name | Event | Which plan a trial or purchase was for |
| customer_type | User | Prospect vs customer, set after login |

## Register a custom dimension

1. **Admin → Data display → Custom definitions → Create custom dimension.**
2. Name it for humans ("Form ID"), choose the scope, and enter the exact parameter name (`form_id`).
3. Save. Data starts appearing within a day or so for new events.

## Test with DebugView

1. Open your site through **tagassistant.google.com** (or Tag Manager **Preview**). This adds the debug parameter.
2. In GA4, open **Admin → DebugView** and select your device.
3. Trigger the action and click the event in the timeline to check parameter names and values.
4. Fix any typo before publishing your Tag Manager container.

A dataLayer push that a Tag Manager GA4 Event tag can read:

```js
window.dataLayer = window.dataLayer || [];
dataLayer.push({
  event: 'generate_lead',
  form_id: 'demo_request',
  page_type: 'pricing'
});
```

> **Pro move:** add `page_type` as an event parameter on the Google tag (for example via a lookup table in Tag Manager based on page path). It turns every report and exploration into a content-type report without regex filters.

*Our view:* a short tracking plan, one row per event and parameter with owner and purpose, is the most useful GA4 document a team can keep.

Next: [BigQuery export on the free tier](https://mentionx.ai/learn/ga4/ga4-bigquery-export-free-tier). Or return to the [GA4 for Marketers track](https://mentionx.ai/learn/ga4/ga4-for-marketers).

## Common questions

**Why doesn't my event parameter show in reports?** Parameters only appear as dimensions after you register them as custom dimensions. Registration is not retroactive, so register early.

**How many custom dimensions can I create?** Standard properties allow 50 event-scoped custom dimensions and 50 custom metrics; Analytics 360 allows 125 of each. User-scoped limits are lower.

**How do I see my own test events?** Enable debug mode with Tag Assistant or Tag Manager preview, then open Admin → DebugView. Your device appears in the device selector.

## Sources

- Google Analytics Help, [About custom dimensions and metrics](https://support.google.com/analytics/answer/10075209)
- Google Analytics Help, [Monitor events in DebugView](https://support.google.com/analytics/answer/7201382)
- Google Analytics Help, [Event collection limits](https://support.google.com/analytics/answer/9267744)
- All accessed 4 Nov 2026.

## Frequently asked questions

### Why doesn't my event parameter show in reports?

Parameters only appear as dimensions after you register them as custom dimensions. Registration is not retroactive, so register early.

### How many custom dimensions can I create?

Standard properties allow 50 event-scoped custom dimensions and 50 custom metrics; Analytics 360 allows 125 of each. User-scoped limits are lower.

### How do I see my own test events?

Enable debug mode with Tag Assistant or Tag Manager preview, then open Admin → DebugView. Your device appears in the device selector.

---

Written and reviewed by Dipuck Jones for MentionX Learn. The HTML version of this page: https://mentionx.ai/learn/ga4/ga4-custom-dimensions-debugview