[GA4] Create user-scoped custom dimensions

Create user-scoped custom dimensions to report on custom user properties. When you add a custom user property to your website or app code, the user-scoped custom dimension unlocks the ability to dissect and understand the user-specific data.

Before you begin

• Don't create a custom user property if a predefined user dimension already exists.
• Add the custom user property to your website or mobile app.
• Make sure the custom user property is being collected. For example, you can use the Users by User property card in the Realtime report.
• Make sure you're an editor or administrator.

Instructions

1. In Admin, under Data display, click Custom definitions.
2. Select the Custom dimensions tab
3. Click Create custom dimensions.
4. Complete the following fields:

   Field	Description
   Dimension name	Enter a unique name for the new dimension. The name you choose will appear in your reports and ad platform. You can't use hyphens in the name, but you can use underscores and spaces instead.
   Scope	Select User to create a user-scoped custom dimension. You can't change this field after you save the new dimension.
   Description	Optional text used to identify the user-scoped custom dimension.
   User property	Enter the name of the custom user property in your website or app code. You can't change this field after you save the new dimension.

5. Click Save.

Example

You configure a user property called profession, which you use to collect each user's profession. To analyze different user professions in your reports, you create the following user-scoped custom dimension:

• Dimension name: Profession
• Scope: User
• Description: The profession of a user
• User property: profession

Next steps

Analyze the custom dimension in a report

If you are an editor or administrator, you can add the custom dimension to any report after 24-48 hours from when the custom data was sent and the custom dimension was created.

Learn how to Customize dimensions in detail reports.

Analyze the custom dimension in an exploration

To add the custom dimension to a free-form exploration:

1. In Google Analytics, click Explore on the left.
2. Create or open a free-form exploration.
3. In the Variables column on the left, click + next to Dimensions.
4. Click the Custom tab at the top.
5. Select the custom dimension.
6. Click Import.
7. Drag the dimension from the Variables column.
8. Drop the dimension into Rows or Columns in the Settings column.

Build an audience using the dimension

To build an audience using the custom dimension:

1. In Admin, under Data display, click Audiences.
2. In the top right, click New audience.
3. Click Create a custom audience.
4. Expand the Add new condition drop down.
5. Select Custom, then select the custom dimension.
6. Add a filter, then click Save.