Analytics and Tracking

User Property

Also called User-scoped custom dimension

A lasting attribute attached to a visitor, such as plan or account type, that applies to all their sessions.

Quick facts: User Property

Category
Analytics and Tracking
Also called
User-scoped custom dimension
Level
Intermediate
Affects
Segmentation, audience building, report depth
Where to see it
GA4 (Admin, Custom definitions, DebugView), Google Tag Manager
In this article4
  1. How a user property works
  2. Why user properties matter
  3. Common mistakes with user properties
  4. How to act on it

How a user property works

A user property is a name-and-value pair you attach to a visitor rather than to something they did. You set it from your tag, from the Google tag configuration, from Google Tag Manager or from the Measurement Protocol, and GA4 stores it against that visitor’s identifier. From that point on it applies to everything they record, in the current visit and in later ones, until you send a different value.

Because it replaces rather than accumulates, a user property always describes the present state. Plan level, account type, whether someone is a registered customer, which language they chose, which branch or city they signed up at — all of these are natural fits. Once registered as a custom definition in the admin area, the property becomes a dimension you can use in reports, explorations and audience rules.

Why user properties matter

They let you split behaviour by who someone is instead of only by what they clicked. That is usually where the useful finding sits: existing customers behaving differently from first-time visitors, one plan converting on a different page from another, a segment that reads plenty and never enquires.

They also make audiences durable. An audience built on a user property keeps its members between visits because the attribute travels with the person, which is what you want for anything you intend to exclude, nurture or compare over months rather than days. Set alongside your events, they turn a user-scoped view of the data into something you can act on.

Common mistakes with user properties

The largest is privacy. Names, email addresses, phone numbers and anything else that identifies a person directly must never be sent to GA4, and hashing them is not a licence either. If you need a login-based identifier, that is what the User-ID feature exists for, and it needs its own decision and disclosure.

The second is scope confusion. Anything that changes within a visit — the campaign that brought someone in, the page they landed on, the device they used — belongs to session or event scope. Forced into a user property, it produces reports where one label is smeared across visits it never described.

The third is volume. GA4 limits how many user properties a property can register, and values with a very large number of variations are of little use as report rows anyway. The fourth is expecting history: a property applies from the moment it is received and never backfills earlier data.

How to act on it

Start by writing the sentences you want to be able to say about your customers, then work back to the smallest set of properties that would make them true. Three or four well-chosen attributes with tidy, stable values beat a long list nobody maintains.

Send each one as early in the visit as you can, so the events that follow are covered, and check the values in the debug view before you rely on a report. Keep a short written note of every property, what it means and who owns it — that document is the difference between an account that still makes sense next year and one that does not. If you are building this at the same time as events and key events, treat it as part of the GA4 setup plan.

Do and do not

Do

  • Send the property early in the visit
  • Keep values short, tidy and few in number
  • Document what each property means and who owns it

Do not

  • Send names, emails, phone numbers or exact addresses
  • Use a property for something that changes mid-visit
  • Expect a new property to fill in older data

Questions people ask about this

What can I safely send as a user property?

Attributes that describe a category of person rather than the individual. Plan or membership tier, account type, customer or prospect, preferred language, self-declared industry and signup source are all reasonable. Anything that could identify someone on its own, such as a name, email address, phone number or full postal address, must stay out of GA4 entirely.

Is a user property the same as a User-ID?

No. A User-ID is your own stable identifier for a logged-in person and is used to stitch their activity across devices. A user property is a descriptive attribute attached to whoever GA4 currently thinks the visitor is. You can use user properties without ever enabling User-ID, and many sites should.

How long does a user property last?

Until it is replaced or the underlying identifier is lost. GA4 keeps the most recent value it received against that visitor, so a property survives across sessions without being resent. If the person clears their cookies, switches browser or uses a different device without logging in, they look like a new visitor and the property starts again.

Related terms

Found this useful?

Share it, or ask an AI to summarise it

Back to the glossary

Knowing the term is the easy part

Applying it to your own site and budget is the work. Book a call and I will tell you what actually applies to you.