# User Fields

### About this export

| Field | Value |
| --- | --- |
| **content_type** | lesson |
| **platform** | contentstack-academy |
| **source_url** | https://www.contentstack.com/academy/courses/lytics-essentials/user-fields |
| **course_slug** | lytics-essentials |
| **lesson_slug** | user-fields |
| **markdown_file_url** | /academy/md/courses/lytics-essentials/user-fields.md |
| **generated_at** | 2026-04-28T06:55:47.697Z |

> Part of **[Lytics Essentials](https://www.contentstack.com/academy/courses/lytics-essentials)** on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys.

<!-- ai_metadata: {"lesson_id":"05","type":"video","duration_seconds":76,"video_url":"https://cdn.jwplayer.com/previews/6kRgnIG5","thumbnail_url":"https://cdn.jwplayer.com/v2/media/6kRgnIG5/poster.jpg?width=720","topics":["User","Fields"]} -->

#### Video details

#### At a glance

- **Title:** UserFields - Overview
- **Duration:** 1m 16s
- **Media link:** https://cdn.jwplayer.com/previews/6kRgnIG5
- **Publish date (unix):** 1751288910

#### Streaming renditions

- application/vnd.apple.mpegurl
- audio/mp4 · AAC Audio · 114150 kbps
- video/mp4 · 180p · 180p · 143708 kbps
- video/mp4 · 270p · 270p · 158068 kbps
- video/mp4 · 360p · 360p · 177403 kbps
- video/mp4 · 406p · 406p · 188928 kbps
- video/mp4 · 540p · 540p · 217575 kbps
- video/mp4 · 720p · 720p · 266934 kbps

#### Timed text tracks (delivery)

- **thumbnails:** `https://cdn.jwplayer.com/strips/6kRgnIG5-120.vtt`

#### Transcript

As we covered in the user profile overview, a user profile is made up of many user fields, or attributes. In this case, email, Pardot prospect ID, Salesforce contact IDs, email domains, and so on are all referred to as a user field. User fields are the output of a data mapping process called LQL, where we translate the raw event information you pass through an API or through a JavaScript tag into a human-readable, consistent format called a user field. We'll touch on both data collection and LQL in further modules, but just know that user fields make up your primary schema that you interact with throughout the Linux UI. For instance, when building an audience, you can go to custom rules and see a list of every single user field that has been mapped to this account. I can go to user fields such as country and build a segment on just those that are known to be within the US. Simply go to data and user fields. This will give you a breakdown of every user field that's been mapped to your current account, a sample of the data that's within it, and an easy access point to go back to the segment builder. As you add additional channel data from our integrations, or continue to expand on your LQL mappings, new user fields will show up here for you to engage with.

#### Subtitles (WebVTT)

```webvtt
WEBVTT

1
00:00:00.000 --> 00:00:07.000
As we covered in the user profile overview, a user profile is made up of many user fields, or attributes.

2
00:00:07.000 --> 00:00:15.000
In this case, email, Pardot prospect ID, Salesforce contact IDs, email domains, and so on are all referred to as a user field.

3
00:00:15.000 --> 00:00:27.000
User fields are the output of a data mapping process called LQL, where we translate the raw event information you pass through an API or through a JavaScript tag

4
00:00:27.000 --> 00:00:31.000
into a human-readable, consistent format called a user field.

5
00:00:31.000 --> 00:00:40.000
We'll touch on both data collection and LQL in further modules, but just know that user fields make up your primary schema that you interact with throughout the Linux UI.

6
00:00:40.000 --> 00:00:49.000
For instance, when building an audience, you can go to custom rules and see a list of every single user field that has been mapped to this account.

7
00:00:49.000 --> 00:00:55.000
I can go to user fields such as country and build a segment on just those that are known to be within the US.

8
00:00:55.000 --> 00:01:02.000
Simply go to data and user fields. This will give you a breakdown of every user field that's been mapped to your current account,

9
00:01:02.000 --> 00:01:07.000
a sample of the data that's within it, and an easy access point to go back to the segment builder.

10
00:01:07.000 --> 00:01:16.000
As you add additional channel data from our integrations, or continue to expand on your LQL mappings, new user fields will show up here for you to engage with.

```

```transcript
<!-- PLACEHOLDER: replace with real transcript before publish if cues were auto-derived from WebVTT -->
[00:00] As we covered in the user profile overview, a user profile is made up of many user fields, or attributes.
[00:07] In this case, email, Pardot prospect ID, Salesforce contact IDs, email domains, and so on are all referred to as a user field.
[00:15] User fields are the output of a data mapping process called LQL, where we translate the raw event information you pass through an API or through a JavaScript tag
[00:27] into a human-readable, consistent format called a user field.
[00:31] We'll touch on both data collection and LQL in further modules, but just know that user fields make up your primary schema that you interact with throughout the Linux UI.
[00:40] For instance, when building an audience, you can go to custom rules and see a list of every single user field that has been mapped to this account.
[00:49] I can go to user fields such as country and build a segment on just those that are known to be within the US.
[00:55] Simply go to data and user fields. This will give you a breakdown of every user field that's been mapped to your current account,
[01:02] a sample of the data that's within it, and an easy access point to go back to the segment builder.
[01:07] As you add additional channel data from our integrations, or continue to expand on your LQL mappings, new user fields will show up here for you to engage with.
```

#### Lesson text

Understand the basics of how user fields are defined in Lytics and where to access them in your account.

## Overview

**Note:** On January 10, 2023, we upgraded our UI with a new, refreshed interface. All of the underlying functionality is the same, but you will notice that things look a little different from this Academy guide. The most notable change is that the navigation menu has moved from the top of the app to the left side. We appreciate your patience as we work on updating our Academy.

**What will I learn?**

*   What is a User Field?
*   How are User Fields defined?
*   Where do I access my user fields?

User Fields are defined by a mapping layer that we call the **Lytics Query Language** (**LQL**). This layer determines the schema for a User Profile and ultimately dictates how your raw event data passed to Lytics are represented on a User Profile. In addition, LQL is responsible for managing rules related to Identity Resolution.

*   User fields are a filtered and aggregated view of your raw data.
*   Although Lytics will collect and store all data you send, in order to keep your marketing efforts focused, not all of the data is surfaced.

![User\_Fields\_-\_Lytics\_data\_funnel\_processed\_events.png](https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltba80d1af532824af/68628cb5e8e8e64be45cf2dc/User_Fields_-_Lytics_data_funnel_processed_events.png)

## Knowledge Check

### Match the term to its definition

User Field

A filtered and aggregated view of your raw user data.

Unique Identifier

A living record of an individual that interacts with your brand.

User Profile

A special type of user field that matches and merges user data across different sources.

**Where can you find user fields in the Lytics UI?**

A. User Fields tab

B. User Profile

C. Audience Builder

D. Schema Audit tab

E. All of the above

Answer: E

**All user fields mapped in your account are available in the Lytics Audience Builder.**

A. True

B. False

Answer: A - True. You can find all user fields in the Custom Rule tab of the Audience Builder.

## Next Steps

To continue learning about Lytics User Fields, check out these resources next.

### Academy Courses

*   Identity Resolution
*   Lytics Data Flow

### Documentation

*    [User Fields](https://learn.lytics.com/documentation/product/features/data-onboarding-and-management/user-fields)

#### Key takeaways

- Connect **User Fields** back to your stack configuration before moving to the next module.
- Capture one concrete artifact (screenshot, Postman call, or code snippet) that proves the step works in your environment.
- Re-read the delivery versus management boundary for anything you changed in the entry model.

## Supplement for indexing

### Content summary

User Fields. Understand the basics of how user fields are defined in Lytics and where to access them in your account. Overview Note: On January 10, 2023, we upgraded our UI with a new, refreshed interface. All of the underlying functionality is the same, but you will notice that things look a little different from this Academy guide. The most notable change is that the navigation menu has moved from the top of the app to the left side. We appreciate your patience as we work on updating our Academy. What will I learn? What is a User Field? How are User Fields defined? Where do I access my user fields? User Fields are defined by a mapping layer that we call the Lytics Query Language ( LQL ). This layer det

### Retrieval tags

- User
- Fields
- lytics-essentials
- lesson 05
- User Fields
- lytics-essentials lesson

### Indexing notes

Index this lesson as a primary chunk tagged with lesson_id "05" and topics: [User, Fields].
Parent course slug: lytics-essentials. Use asset_references URLs as thumbnail hints in search results when present.
Never surface LMS quiz content or assessment answers from this file.

### Asset references

| Label | URL |
| --- | --- |
| Video thumbnail: User Fields | `https://cdn.jwplayer.com/v2/media/6kRgnIG5/poster.jpg?width=720` |
| User\_Fields\_-\_Lytics\_data\_funnel\_processed\_events.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltba80d1af532824af/68628cb5e8e8e64be45cf2dc/User_Fields_-_Lytics_data_funnel_processed_events.png` |

### External links

| Label | URL |
| --- | --- |
| Contentstack Academy home | `https://www.contentstack.com/academy/` |
| Training instance setup | `https://www.contentstack.com/academy/training-instance` |
| Academy playground (GitHub) | `https://github.com/contentstack/contentstack-academy-playground` |
| Contentstack documentation | `https://www.contentstack.com/docs/` |
| User\_Fields\_-\_Lytics\_data\_funnel\_processed\_events.png | `https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltba80d1af532824af/68628cb5e8e8e64be45cf2dc/User_Fields_-_Lytics_data_funnel_processed_events.png` |
| User Fields | `https://learn.lytics.com/documentation/product/features/data-onboarding-and-management/user-fields` |
