Guide 92 · Admin · GA4 + Tag Manager
Custom dimension and metric registration lag: the 24 to 48 hour wait, and how to check it
A custom dimension or metric becomes usable in reports 24 to 48 hours after the data was sent and the definition was created. Plan the check for the second day, not the first hour.
After the trace, the registration date is written down, the usable window is dated, and the check is scheduled for the second day after registration.
Download the reference: the custom dimension registration lag reference (JSON) (449 bytes, MD5 c9db8fa39ab88205fc5a010edf79f830). It holds the worked example from this guide with every figure recomputed. The file was built for this guide and checked the same day; it was not exported from a live property.
What you need
- The date and time the custom dimension or metric was created.
- The date the parameter was first sent, confirmed in DebugView or Realtime.
- Editor access, so you can see the definition in Custom definitions.
The trace
- Write down two dates: when the parameter was first sent, and when the custom definition was created. The wait runs from the later of the two. A dimension created before the parameter was ever sent waits from the first send.
- Add 24 hours for the earliest usable time, and 48 hours for the latest. A definition created on 11 November at 09:00 is usable from 12 November at 09:00 at the earliest, and by 13 November at 09:00 at the latest. That is a 24-hour window, not a single moment.
- Do not check in the first hour. A dimension checked an hour after creation will not appear in the report builder, and that absence proves nothing. The check belongs on the second day.
- On the second day, open a report and add the dimension. If it appears, the registration worked. If it does not appear by the end of the 48-hour window, read the definition back: scope, parameter name and spelling, against the code.
- Check the worked example in the download. Three definitions were created on 11 November: one event-scoped, one item-scoped and one metric. All three share the same window, usable from 12 November and by 13 November. The count of checks to run is 3, not 1.
- Note the exception for user data import. A user-scoped dimension used for import needs up to 4 hours before Analytics recognizes the imported data, and up to 24 hours before that data appears in reports. That is a different clock from the 24 to 48 hour rule.
Dead ends
DEAD END — CHECKING TOO EARLY AND REBUILDING. A dimension rebuilt because it did not appear in the first hour creates a duplicate with a different name. Wait out the window first.
DEAD END — THE WRONG CLOCK FOR IMPORT. Imported user data follows the 4-hour and 24-hour clocks in the import guide. Judging it by the 24 to 48 hour rule misreads the delay.
DEAD END — EXPECTING PAST DATA TO APPEAR. The wait is about new data becoming usable. Data from before the definition was created never appears under it, however long you wait.
End state
Three definitions created on 11 November share one window: usable from 12 November, and by 13 November at the latest. The check is dated, not guessed.
Sources
- Analytics Help — Create event-scoped custom dimensions — usable after 24 to 48 hours from when the custom data was sent and the custom dimension was created
- Analytics Help — Create custom metrics — the same 24 to 48 hour wait for custom metrics
Checked 11 November 2026. The click paths above are the ones in Google's help and developer pages, opened 11 November 2026. No step in this guide was run inside a live Analytics property or a live Tag Manager container, because both need a Google sign-in and this site does not sign in as anyone. The figures on this page were recomputed in Python 3 and are shown in the downloadable file, which was checked the same day. Google moves menu items without warning; if a path on this page no longer matches, the linked help page is the current map.