User Traits
Configure and manage user traits
User traits are the attributes that describe your users in encatch. You can think of them as columns in a spreadsheet: each trait holds one kind of information (e.g. email, plan, country). Traits are used for segmentation, personalization, and for including user context in feedback responses.
Traits are created in two ways:
- Automatically when you identify users and send data (e.g. via SDK or API), if Allow new traits from clients is enabled for the project.
- Manually in the User Traits table by clicking Create Trait, so you can define traits before connecting a data source or use them in segments.
Where to find it
- Open your project in the encatch dashboard.
- Go to Settings.
- Under User Data, open User Traits.
If you do not see User Traits, contact your organization administrator—you may need additional access.
The page heading is User Traits with the description: Manage user traits for this project.
Trait properties
Each trait has the following properties:
| Property | Description |
|---|---|
| Slug | System identifier used in API/SDK and storage. Lowercase letters, numbers, and underscores only (e.g. plan, phone_number). For system-generated traits, the slug cannot be changed. |
| Name | Display name shown in the dashboard (e.g. "Plan", "Phone Number"). You can rename this at any time. |
| Data type | The kind of value the trait holds: Text, Numeric, Datetime, or Boolean. |
| Include in feedback response | When enabled, this trait is included in feedback response payloads so you can filter or group feedback by it in Reports. A project limit applies (see below). |
Data types
encatch supports these data types for traits:
- Text – String values (e.g. name, email, free text).
- Numeric – Numbers (e.g. login count, score).
- Datetime – Dates/times (e.g. first seen, last login).
- Boolean – True/false values.
When creating a trait manually, you choose the data type. For traits created from client data (identify calls), the type is inferred from the payload.
System-generated traits
Each project is initialized with a set of system-generated traits. These represent core user and activity metadata:
| Slug | Name | Description |
|---|---|---|
user_name | Username | User's username |
display_name | Display Name | Display name |
email | Email address | |
first_seen_at | First seen at | When the user was first seen |
last_seen_at | Last seen at | When the user was last seen |
feedback_views_count | Feedback Views Count | Number of times the user saw a feedback form |
last_feedback_view | Last Feedback View | When the user last saw a feedback form |
last_feedback_submission | Last Feedback Submission | When the user last submitted feedback |
feedback_response_count | Feedback Response Count | Total number of feedback submissions |
For system-generated traits:
- The slug is fixed (locked) and cannot be changed.
- The name can be edited.
- Include in feedback response can be toggled only where the trait is available for feedback response.
- System traits cannot be deleted or disabled.
Allow new traits from clients
At the top of the User Traits page, the Allow new traits from clients option controls whether new traits can be created automatically when user data is sent (e.g. via identify calls from your app or API).
- Enabled – Any attribute you send when identifying a user can create a new trait if it does not already exist.
- Disabled – Only values for existing traits are stored; unknown attributes are ignored. Use this when you want strict control and no new columns from client data.
You can still create traits manually regardless of this setting.
Some fields (such as device and session metadata) are controlled from Data Settings under Feedback Response, not from the User Traits table.
Managing traits
Create a trait
- Go to Settings → User Data → User Traits for the project.
- Click Create Trait.
- In the Create New Trait dialog, enter:
- Slug – Lowercase, letters, numbers, and underscores only. Must be unique in the project.
- Name – Human-readable label.
- Data type – Text, Numeric, Datetime, or Boolean.
- Include in feedback response – Optional; subject to the project limit (see below).
- Click Create.
Rename a trait
Edit the Name field in the table and save. The slug (system identifier) does not change. System-generated traits can be renamed; only the display name is updated.
Include in feedback response
Use the Feedback Response checkbox for each trait to include it in feedback response payloads. This is useful for filtering or grouping feedback in Reports.
- A maximum of 25 traits per project can be included in the feedback response. Once the limit is reached, you must uncheck another trait before checking a new one.
- Some system traits may not be available for feedback response.
- Traits reserved for Data Settings show as controlled by Data Settings and cannot be toggled here.
Usage information
The In Use column shows whether a trait is referenced in:
- Segments – Used in segment filters.
- Feedback – Used in feedback-related configuration.
Click the usage indicator to see details. Traits that are in use cannot be disabled or deleted until they are removed from those usages.
Disable a trait
For traits that support it, use the Pause (disable) action. Disabled traits are ignored for new incoming data. System-generated traits and traits that are in use cannot be disabled. Use Play to enable again.
Delete a trait
Use the Delete action for custom traits that are not in use. Deleting removes the trait from the project. System-generated traits cannot be deleted.
Feedback response limit
Only a limited number of traits per project can be marked as Include in feedback response (up to 25). Choose the traits that are most useful for filtering and reporting. You can change which traits are included at any time within the limit.
Best practices
- Slugs: Use clear, stable slugs (e.g.
plan,country,signup_date). Avoid changing them in your app after traits are in use. - Allow new traits: Turn Allow new traits from clients off if you want to restrict which attributes are stored and avoid accidental trait proliferation.
- Feedback response: Only include traits you actually need in reports and integrations to stay within the feedback response limit.
Was this page helpful?